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Programming 


If you ’ve used a calculator or computer before, you’re probably 
familiar with the idea of programs . Generally speaking, a program is 
something that gets the calculator or computer to do certain tasks 
for you—more than a built-in command might do. In the HP 48, a 
program is an object that does the same thing. 


Understanding Programming 

An HP 48 program is an object with £ & delimiters containing a 
sequence of numbers, commands, and other objects you want to 
execute automatically to perform a task. 

For example, a program that takes a number from that stack, finds its 
factorial, and divides the result by 2 would look like this: ■£ ! 2 :$• 

or 

I 

i- 





The Contents of a Program 

As mentioned above, a program contains a sequence of objects. As 
each object is processed in a program, the action depends on the type 
of object, as summarized below. 
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Actions for Certain Objects in Programs 


Object 

Action 

Command 

Executed. 

Number 

Put on the stack. 

Algebraic 

i Put on the stack. 1 

String 

1 Put on the stack. 

List 

Put on the stack. 

Program 

Put on the stack. 

Global name (quoted) 

Put on the stack. 

Global name (unquoted) 

■ Program executed. 

■ Name evaluated. 

■ Directory becomes current. 

■ Other object put on the stack. 

Local name (quoted) 

Put on the stack. 

Local name (unquoted) 

Contents put on the stack. 


As you can see from this table, most types of objects are simply put 
on the stack—but built-in commands and programs called by name 
cause execution . The following examples show the results of executing 
programs containing different sequences of objects. 


Examples of Program Actions 


Program 

Results 

« i 2 3- 

« -L 

is 2 

« "Hello" £ fl B > 3- 

2: "Hello" 

l: C fl B y 

■$: 1 1+2 1 

is '1+2' 

■$: ’ 1+2' -+NUM & 

1 4 a O 

! I » O 

■$: <k 12 + » :*• 

1 it 1 T jV I 

•*: •*: 1 2 + * EVflL » 

1 “ o 

l “ ■-* 
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Programs can also contain structures . A structure is a program 
segment with a defined organization. Two basic kinds of structures are 
available: 


■ Local variable structure. The 4 command defines local variable 
names and a corresponding algebraic or program object that’s 
evaluated using those variables. 

■ Branching structures. Structure words (like DO ... UNTIL ... 
END) define conditional or loop structures to control the order of 
execution within a program. 

A local variable structure has one of the following organizations inside 
a program: 


4 namei 
4 namei 


name n 1 algebraic 1 > 
name n <£ program :$■ 


The —► command removes n objects from the stack and stores them 
in the named local variables. The algebraic or program object in 
the structure is automatically evaluated because it’s an element of 
the structure—even though algebraic and program objects are put 
on the stack in other situations. Each time a local variable name 
appears in the algebraic or program object, the variable’s contents are 
substituted. 


So the following program takes two numbers from the stack and 
returns a numeric result: 



a b 





Calculations in a Program 

Many calculations in programs take data from the stack. Two typical 
ways to manipulate stack data are: 

■ Stack commands. Operate directly on the objects on the stack. 

■ Local variable structures. Stores the stack objects in temporary 
local variables, then uses the variable names to represent the data in 
the following algebraic or program object. 

Numeric calculations provide convenient examples of these methods. 
The following programs use two numbers from the stack to calculate 

the hypotenuse of a right triangle using the formula yx 2 + y 1 . 
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sa + f :$■ 

x SQ y SQ + T 




The first program uses stack commands to manipulate the numbers 
on the stack—the calculation uses stack syntax. The second program 
uses a local variable structure to store and retrieve the numbers—the 
calculation uses stack syntax. The third program also uses a local 
variable structure—the calculation uses algebraic syntax. Note that 
the underlying formula is most apparent in the third program. This 
third method is often the easiest to write, read, and debug. 


Entering and Executing Programs 

A program is an object—it occupies one level on the stack, and you 
can store it in a variable. 

To enter a program: 

1. Press 5) f« »] . The PRG annunciator appears, indicating 
Program-entry mode is active. 

2. Enter the commands and other objects (with appropriate 
delimiters) in order for the operations you want the program to 
execute. 

■ Press [SPCl to separate consecutive numbers. 

■ Press © to move past closing delimiters. 

3. Optional: Press fr>](<—*1 (newline) to start a new line in the 

command line at any time. 

4. Press (ENTER) to put the program on the stack. 

In Program-entry mode (PRG annunciator on), command keys 
aren’t executed—they’re entered in the command line instead. Only 
nonprogrammable operations such as Q and (VAR] are executed. 

Line breaks are discarded when you press (ENTER] . 

To enter commands and other objects in a program: 

■ Press the keyboard or menu key for the command or object, 
or 

■ Type the characters using the alpha keyboard. 
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To store or name a program: 

1. Enter the program on the stack. 

2. Enter the variable name (with 1 delimiters) and press (STQ) . 

You can choose descriptive names for programs. Here are some ideas 
of what the name can describe: 

■ The calculation or action. Examples: SPH (spherical-cap volume), 
SORT (sort a list). 

■ The input and output. Examples: X-^FX (x to /(#)), RH—>V 
(radius-and-height to volume). 

■ The technique. Example: SPHLV (spherical-cap volume using local 

To execute a program: 

■ Press (VAR) then the menu key for the program name. 

or 

■ Enter the program name (with no delimiters) and press (ENTER) , 
or 

■ Put the program name in level 1 and press (EVAL) , 
or 

■ Put the program object in level 1 and press (EVAL) . 

To stop an executing program: 

■ Press (CANCEL) . 

Example: Enter a program that takes a radius value from the stack 
and calculates the volume of a sphere of radius r using 

V = -tit 3 

3 

If you were going to calculate the volume manually after entering the 
radius on the stack, you might press these keys: 

3 QT) Q© © 4 (ENTER ) 3 0 © SK^NUM) 
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Enter the same keystrokes in a program. ( frHf*- 1 ! just starts a new 
line.) 


S)0 

3 OS3©© 4 fSPCl 3 0© 

©(EDQSMM) 

Put the program on the stack. 


■4t3 A 7f*43^* 

*NUf1 4 

» 


FMT 

HN'3L 

FLhG 

KEY S | 

MENU 

MISC 


fENTER1 


1: «3 ir*43/* 

+NUM » 

final 


mN'3L 

Iflhg keys i 

MENU 

M1S C 


Store the program in variable VOL. Then put a radius of 4 on the 
stack and run the VOL program. 


CD VOL fSTOl 

4 [VAR 11 


US 


1* 268.082573106 


‘.‘□L EtfhM IDPhfi N IVF; PV 


The program is 



-*"i 

v 1 


it * 4 



Example: Replace the program from the previous example with 
one that's easier to read. Enter a program that uses a local variable 
structure to calculate the volume of a sphere. The program is 




t r*r 




(You need to include —*NUM because 7r causes a symbolic result.) 


Enter the program. ( 



just starts a new line.) 



« » 



E@ r fSPC) 

CD403 

r(Z] 3 ©(a(H) 

(»tK-»NUM) 


« * r 1 4^3*ir*r' s 3 1 
+NUM 


VOL 

EKftM 

1 (DPhF; 

N 

i:-: 1 

rfi 

PV 1 


Put the program on the stack, store it in VOL, and calculate the 
volume for a radius of 4. 



1: 268.082573106 


VOL EKfiM IOPmF; N RVfc PV 
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Example: Enter a program SPH that calculates the volume of a 

spherical cap of height h within a sphere of radius R using values 
stored in variables H and R . 



In this and following chapters on programming, “stack diagrams 57 show 
what arguments must be on the stack before a program is executed 
and what results the program leaves on the stack. Here’s the stack 
diagram for SPH . 


Level 1 


Level 1 


volume 


The diagram indicates that SPH takes no arguments from the stack 
and returns the volume of the spherical cap to level 1. (SPH assumes 
that you’ve stored the numerical value for the radius in variable R 
and the numerical value for the height in variable H . These are global 
variables—they exist outside the program.) 

Program listings are showm with program steps in the left column and 
associated comments in the right column. Remember, you can either 
press the command keys or type in the command names to key in the 
program. In this first listing, the keystrokes are also shown. 
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Program: 



* m 



■ * 





HUM 



Keys: 



0103 


©SI© 

®H02 

© 5)0 

3(x)RQ 

H ©© 


Comments: 

Begins the program. 

Begins the algebraic expression to 
calculate the volume. 

Multiplies by nh 2 . 

Multiplies by 3r — h, completing 
the calculation and ending the 
expression. 

Converts the expression with 7r to 
a number. 


(ENTER) 

Q SPH (STOl 


Ends the program. 

Puts the program on the stack. 


Stores the program in variable 

SPH . 


This is the program: 




* .. I I 

/ ."I * IT H 


y. 





Now use SPH to calculate the volume of a spherical cap of radius 
r — 10 and height h — 3. 


First, store the data in the appropriate variables. Then select the 
VAR menu and execute the program. The answer is returned to level 
1 of the stack. 


10 Q R (STo) 

3QH (sto) 

■ ■ a ■ ■ a a in ii | 1 11 IH I i i i i i i I 

(VAR) Iliftiil 

^|P - ■* --- ■ 


1: 254.469004942 


H F; SPH VOL EKrtM IQPftF; 
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Viewing and Editing Programs 

You view and edit programs the same way you view and edit other 
objects—using the command line. 

To view or edit a program: 

1. View the program: 

■ If the program is in level 1, press or ®. 

■ If the program is stored in a variable, use the Memory Browser 
( ^[MEMORY 1 ) to view the variable, or press fVAR) (rH and the 
variable’s menu key, followed by (B 

2. Optional: Make changes. 

3. Press fENTER 1 to save any changes (or press (CANCEL] to discard 
changes) and return to the stack. 

The Memory Browser lets you change a stored program without 
having to do a store operation. f4*y)fEDiT) lets you change a program 
and then store the new version in a different variable. 

While you’re editing a program, you may want to switch the 
command-line entry mode between Program-entry mode (for editing 
most objects) and Algebraic/Program-entry mode (for editing 
algebraic objects). The PRO and HLG annunciators indicate the 
current mode. 


To switch between entry modes: 


Press fr»lf ENTRY). 


Example: Edit SPH from the previous example so that it stores the 
number from level 1 into variable H and the number from level 2 into 
variable R, 


Use EDIT to start editing SPH 


fWl 

©BUM CD 


« 1 1/3*if *H A 2* (3*R-H 

)■ +NUM 

£ 



$ 

kip*k& 

E 

L D 

E 


INS ■ 

-t-i-TK 
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Move the cursor past the first program delimiter and insert the new 

program steps. 



*'H I STO 'R' STO l ]y3„, 
)' *NUM 



4SKIP 

[SKIP* 

4DEL 

p 

E 

L* 

INS ■ 



Save the edited version of SPH in the variable. Then, to verify that 
the changes were saved, view SPH in the command line. 


(ENTER)(VAR 

© 




r ■ r I ’ ■ effW ■ -■-- J J i- ■* J -B ■ ■ J -' 1 • ■ ■ 

r r ■ f p ; a | | ^ iKiLaias... .jij i j. 



4 *H' STO 'R 1 STO 
1 /3*tt*H a 2* C 3*R-H)' 
+NUM 




IN:" ■ t-STK 


Press (CANCEL) to stop viewing. 


Creating Programs on a Computer 

It is convenient to create programs and other objects on a computer 
and then load them into the HP 48 using the calculator’s serial port. 

If you are creating programs on a computer, you can include 
“comments” in the computer version of the program. 

To include a comment in a program: 

■ Enclose the comment text between two @ characters. 

or 

■ Enclose the comment text between one @ character and the end of 
the line. 

Whenever the HP 48 processes text entered in the command line— 
either from keyboard entry or transferred from a computer—it strips 
away the @ characters and the text they surround. However, @ 
characters are not affected if they’re inside a string. 
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Using Local Variables 

The program SPH in the previous example uses global variables for 
data storage and recall. There are disadvantages to using global 
variables in programs: 

■ After program execution, global variables that you no longer need 
to use must be purged if you want to clear the VAR menu and free 
user memory. 

■ You must explicitly store data in global variables prior to program 
execution, or have the program execute STO. 

Local variables address the disadvantages of global variables in 
programs. Local variables are temporary variables created by a 
program. They exist only while the program is being executed and 
cannot be used outside the program. They never appear in the VAR 
menu, in addition, local variables are accessed faster than global 
variables. (By convention, this manual uses lowercase names for local 
variables.) A compiled local variable is a form of local variable that 
can be used outside of the program that creates it. See “Compiled 
Local Variables” on page 1-15 for more information. 

Creating Local Variables 

In a program, a local variable structure creates local variables. 

To enter a local variable structure in a program: 

1. Enter the —► command (press (r*l Q ). 

2. Enter one or more variable names. 

3. Enter a defining procedure (an algebraic or program object) that 
uses the names. 

•*: + name} name 2 ... name n 5 algebraic 1 %■ 

or 

name 1 name 2 ... name n •£ program »■ s* 

When the —► command is executed in a program, n values are taken 
from the stack and assigned to variables name 1 , name 2 , ... name n . 
For example, if the stack looks like this: 
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then 

+ a creates local variable a — 20. 

a b creates local variables a = 6 and 6 = 20* 

* a b c creates local variables a — 10, b — 6, and c = 20. 

The defining procedure then uses the local variables to do calculations. 

Local variable structures have these advantages: 

■ The —* command stores the values from the stack in the 
corresponding variables—you don’t need to explicitly execute STO. 

■ Local variables automatically disappear when the defining procedure 
for which they are created has completed execution. Consequently, 
local variables don't appear in the VAR menu, and they occupy user 
memory only during program execution. 

■ Local variables exist only within their defining procedure—different 
local variable structures can use the same variable names without 
conflict. 

Example: The following program SPIILV calculates the volume of 

a spherical cap using local variables. The defining procedure is an 

algebraic expression. 


Level 2 Level 1 -+ Level 1 

■ -■ ■— i 

r h —► volume 
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Program: 







“h 1 


+NUM 

:$■ 

(ENTER) Q SPHLV fSTOl 


Creates local variables r and h 
for the radius of the sphere and 
height of the cap. 

Expresses the defining procedure. 
In this program, the defining 
procedure for the local variable 
structure is an algebraic 
expression. 

Converts expression to a number. 
Stores the program in variable 

SPHLV . 


Now use SPHLV to calculate the volume of a spherical cap of radius 
r = 10 and height h = 3. Enter the data on the stack in the correct 
order, then execute the program. 


10 (ENTER) 3 

r var i liiiit 


1= 254.469004942 


SPHLV H F; :"PH VOL I ENtiM 


Evaluating Local Names 

* 

Local names are evaluated differently from global names. When a 
global name is evaluated, the object stored in the corresponding 
variable is itself evaluated. (You’ve seen how programs stored in 
global variables are automatically evaluated when the name is 
evaluated.) 

When a local name is evaluated, the object stored in the 
corresponding variable is returned to the stack but is not evaluated. 
When a local variable contains a number, the effect is identical to 
evaluation of a global name, since putting a number on the stack is 
equivalent to evaluating it. However, if a local variable contains a 
program, algebraic expression, or global variable name—and if you 
want it evaluated—the program should execute EVAL after the object 
is put on the stack. 
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Defining the Scope of Local Variables 

Local variables exist only inside the defining procedure. 

Example: The following program excerpt illustrates the availability 
of local variables in nested defining procedures (procedures within 
procedures). Because local variables a, b } and c already exist when 
the defining procedure for local variables d, e, and / is executed, 
they’re available for use in that procedure. 

Program: Comments: 



3 h C "f" 

3 d e t 
1 as l -. d*e+f > 1 



No local variables are available. 
Defines local variables a, 6, c. 
Local variables a, 6, c are 
available in this procedure. 

Defines local variables d } e, /. 
Local variables a, 6, c and rf, e, / 
are available in this procedure. 
Only local variables a, 6, c are 
available. 

No local variables are available. 


Example: In the following program excerpt, the defining procedure 
for local variables d, e, and / calls a program that you previously 
created and stored in global variable PI . 
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cl b + C + 

-+ d e f Defines local variables d, e, /. 

' P1 + a<d * e+f > 1 Local variables a, b i c and d, e, / 

are available in this procedure. 
The defining procedure executes 
the program stored in variable 

PI . 


The six local variables are not available in program PI because they 
didn’t exist when you created PI . The objects stored in the local 
variables are available to program PI only if you put those objects on 
the stack for PI to use or store those objects in global variables. 

Conversely, program PI can create its own local variable structure 
(with any names, such as a. c, and /, for example) without conflicting 
with the local variables of the same name in the procedure that calls 
PI . If is possible to create a special type of local variable that can be 
used in other programs or subroutines. This type of local variable is 
called a compiled local variable. 

Compiled Local Variables 

Global variables use up memory, and local variables can’t be used 
outside of the program they were created in. Compiled local variables 
bridge the gap between these two variable types. To programs, 
compiled local variables look like global variables, but to the calculator 
they act like local variables. This means you can create a compiled 
local variable in a local variable structure, use it in any other program 
that is called within that structure, and when the program finishes, 
the variable is gone. 
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Compiled local variables have a special naming convention: they must 
begin with a For example, 


rfr H” ij 



The variable *y is a compiled local variable that can be used in the 
two programs BELOW and ABOVE. 

Creating User-Defined Functions as Programs 

The defining procedure for a local variable structure can be either an 
algebraic or program object. 

A program that consists solely of a local variable structure whose 
defining procedure is an algebraic expression is a user-defined function. 

If a program begins with a local variable structure and has a 
program as the defining procedure, the complete program acts like 
a user-defined function in two ways: it takes numeric or symbolic 
arguments, and takes those arguments either from the stack or 
in algebraic syntax. However, it does not have a derivative. (The 
defining program must, like algebraic defining procedures, return only 
one result to the stack.) 

There’s an advantage to using a program as the defining procedure for 
a local variable structure: The program can contain commands not 
allowed in algebraic expressions. For example, loop structures are not 
allowed in algebraic expressions. 
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Using Tests and Conditional Structures 

You can use commands and branching structures that let programs 
ask questions and make decisions. Comparison functions and logical 
functions test whether or not specified conditions exist. Conditional 
structures and conditional commands use test results to make 

decisions. 


Testing Conditions 

A test is an algebraic or a command sequence that returns a test result 
to the stack. A test result is either true —indicated by a value of 1—or 
it is false —indicated by a value of 0. 


To include a test in a program: 

■ To use stack syntax, enter the two arguments, then enter the test 
command. 

■ To use algebraic syntax, enter the test expression (with ‘ 
delimiters). 

You often use test results in conditional structures to determine 
which clause of the structure to execute. Conditional structures are 
described under “Using Conditional Structures and Commands 15 on 
page 1-20. 


Example: Test whether or not X is less than Y. To use stack syntax, 
enter 


X Y 


To use algebraic syntax, enter 


i v 

■ m. 

I l 


KJ l 


. (For both cases. 


if X contains 5 and Y contains 10, then the test is true and 1 is 
returned to the stack.) 


Using Comparison Functions 

Comparison functions compare two objects, using either stack syntax 
or algebraic syntax. 
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Comparison Functions 


Key 

Programmable 
j Command 

Description 

fpRGl iHplips (pages 1 and 2): 

■ ■ ■ ■ 1 ■- f. 1. !- B 1. I - ■ i j 4 4 ■ 4.4.. 4 J- - _ _ . , Ij | i i 

B B 1 B 1 1 ■ 4 f I 1 4 4 4 4 4 . J r. L I ■ . i.1 , ! i i 

djifidl 111 1 1 1 .1 14 4. .44.. . M , , , , , 

' ' l{ 4 4 ■ i I44J.4J.____ | . 1 , , . . . )|| 

4 4 - ' - ■ - 1 1 ! ! 1 1 1 ■ 

4 4 4 J'lTil "4 ■ ' i -■ .u a j . tun — s ■ 

... .... y-| --—.. 

44 1 114 144444 - . . ---------- - - S- — 

L L *■ L " 1 -r r r - - i i ■ - r 

4-1 * « * * ' ' * • ■ ■ ■ b _ _ . - r 'r--r ii i i ■ h 

II 1 i ill ... i ii III 

i I I I ■ 1 I ri . i ... l ■ 

!*■* !.<i>< ... 

. ....inn 

ii ii i i i i ii mi i l^i i i i i i ■ i i i i i . i i i i i i 

■ 4b - 4 J - a-. ■ i - r m it ■ i II I- i 

b i -i fe b - i a - - ■ J -#■* ■• ■ - n ■ i rrrrrri i i i i 

........ — B _ _ - ■ a ■■ ■ i a r a. nuiiiiiirii 

i • a a a a ■'a’a-a a. ■■ l— n- if 1 ■ i j ■ rrrrrrrrili 1 
a a a a a a a tit - “■ u ■■ a. a. 1 111 ■ ■ ■ ■ ■ rj- 1 j , ir. 

a a a a a a 1 tttt rT" ifi 1 ■ B B ■ ■ n r ■ r44 ■ 1 JP4- r 

,Y,V A- Wf 

< 

> 

< 

> 

SAME 

1 _ 

Tests equality of two objects. 

Not equal. 

Less than. 

Greater than. 

Less than or equal to. 

Greater than or equal to. 

Identical. Like ==, but doesn't allow a 
comparison between the numerical value 
of an algebraic (or name) and a 
number. Also considers the wordsize of 

1 a binary integer . 

1 J f 1 4 4B 1444 4J4 JB J f .... ......... ..i 

4 i ■ lira a ■ l ■ ■ j > 4 A -J_______. 

4444444-* * *■■■*■».■ J MUi-■- a. - - 1. 1. 

a 1 1 1 1 1 1 1 BBB.BJBB4.4_. ...... ........ . 

1 .1 ■ ■ 1 ■ 1 ■ r 1 l 1 . ■ ■ -- . rr B1 , 

1 I II ! !■• ■ - ------- --- 

4 11! I I ' IV*!------------ -- -- p- rp Brash 

1 1 1 1 1 hi as--?- - - r- arrrr-aBBB-.BBBBBBi 

iliiiii-!SETi--k-*rrr*irraikiiki_k4 

■ 1 1 1 1 1 1 ■ pi ■ ■ r ■ p Ip Lri'iiiiMii p . l . _ . 

1 1 1 1 1 1 * i * i r--.---f.rri r 1 ■ L r r . . ■ _ b _ - b 

1 ■■■ 1 ii ■ 1 r r - r r r r 1 k rii ail ... k k ■ l - _ - 

... > ■*■**' > B L B B--- 

; ; ; | ■ ; ; ■ ■ e ■ r 1 ■ • ' b b _ b b _ b . - - - J - 

..-'■•■-r-rririr.ii- 

1 II 1 1 1 1 II ! 1 ! 1 1 ; .. r r 1 ii i i 1 i 1 

i ■' a - a - ■ ai 1' i a 1 1 ■ rur ri r r ■ 1 r r 1 r 1 r 1 r ii. 

£ 


The comparison commands return 1 (true) or 0 (false) based on the 
comparison—or an expression that can evaluate to 1 or 0* The order 
of the comparison is “level 2 test level 1 ” where test is the comparison 
function. 


All comparison commands except SAME return the following: 


■ If neither object is an algebraic or a name, returns 1 if the two 
objects are the same type and have the same value, or 0 otherwise. 
For example, if 6 is stored in A, X 5 < puts 6 and 5 on the stack, 
then removes them and returns 0. (Lists and programs are 

considered to have the same value if the objects they contain are 
identical. For strings, “less than 55 means “alphabetically previous.”) 


If one object is an algebraic (or name) and the other object is an 
algebraic (or name) or a number, returns an expression that must be 
evaluated to get a test result based on numeric values. For example, 


if 6 is stored in X 


i i cr 


returns 


1 'xV 


) 


then —>NUM returns 0. 


(Note that =— is used for comparisons, while = separates two sides of 
an equation.) 

SAME returns 1 (true) if two objects are identical. For example, 

1 X+3 1 4 SAME returns 0 regardless of the value of X because the 
algebraic 1 X+3 1 is not identical to the real number 4. Binary integers 
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must have the same wordsize and the same value to be identical. For 
all object types other than algebraics, names, and binary integers, 
SAME works just like =—. 

You can use any comparison function (except SAME) in an algebraic 
by putting it between its two arguments. For example, if 6 is stored in 

X, 1 X<5 1 +NUM returns 0. 

Using Logical Functions 

Logical functions return a test result based on the outcomes of two 
previously executed tests. Note that these four functions interpret any 
nonzero argument as a true result. 


Logical Functions 


Keys 

Programmable 

Command 

Description 

f'PRGl 8MB 

i§» (page 2): 


iiiii.1 ■ l ■ ) tli i« ■ i ■ * - - ■ ■ ■ ■ i ■■■-q-s-'ir 

■ 1 i 8 ■ i ■ i 1 US i - i»l" J S|r ■F rrr " rrr 

- i i i 1 ■ ■ ijj“ 1 - # - ■ I - fr | ■ran . 

\ -■.'.'.■T-V J.Tv/l, L 1 : v.\ 

■ ■ ■ i P ■ 1 li l> fa - ■ fa ■ fa ■ P 

AND 

Returns 1 (true) only if both arguments 
are true. 

V.V.Y.Y/ V. fWt V.V.-.V.V.V.". 

1 1 1 1 J I J . HI 'll'' - • L L ■ 

9.1 ' i .-ifi>i—-ri 

1 I-H1 -1-B - HBH . . 1 1 ■ T pf- TT1H- —* — 

■ ■■■ii i .ai «lii a ^inTiiT«T*TTT-“”“jis-«i* 

OR 

Returns 1 (true) if either or both 
arguments are true. 

1 fa fa fa ■ p fc ■ fc ■ '_B h ■ mmmm p ■ ! r ■ - ■ I 1 p----- i 

feMQ m 

iiiniii^ffpfll | || | || | || | ; ; ; ;; { ill 

XOR 

Returns 1 (true) if either argument, but 
not both, is true. 

V-'.-.V. 1 , L | iWivSp.v.v.v.v. 

^rrprHi fa iT, •XL* 1 -- ■ —- 

■ «■ r p p Ml.- + r#i 'M* - fa fa fa -•>- fa 

ppfaSrBr+pifari p 4 fa jfaFn faifafa B -T B —t — t-bb* 1 

kltitth ■ -fa fas rtffafairi'fai utistti t - a »■ - ttt- - a- 

NOT 

Returns 1 (true) if the argument is 0 
(false); otherwise, returns 0 (false). 


AND, OR, and XOR combine two test results. For example, if 4 is 
stored in Y, V 8 < 5 FIND returns 1. First, V 8 < returns 1 to the 
stack. AND removes 1 and 5 from the stack, interpreting both as true 

results, and returns 1 to the stack. 


NOT returns the logical inverse of a test result. For example, if 1 is 
stored in X and 2 is stored in Y, X ¥ < HOT returns 0. 


You can use AND, OR, and XOR in algebraics as infix functions. For 
example, 1 3< 5 XOR 4>7* +NUM returns 1. 


You can use NOT as a prefix function in algebraics. For example, 
1 HOT Z^4 ' 4HUM returns 0 if J? = 2. 
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Testing Object Types 

The TYPE command ( fPRGl — (NXT| BHB takes any 


object as its argument and returns the number that identifies that 
object type. For example, “HELLO" TYPE returns 2, the value for 


a string object. See the table of object types in chapter 3, in the 
TYPE command, to find HP 48 objects and their corresponding type 
numbers. 


Testing Linear Structure 


The LIN IN command ( fPRGj fNXT ] HEir 


1 " ■ ■ ■ ■ ■ Bn■ ■ »■ *■ - 

■ 4 il i [Ht ■ ■ rflr ■ i i l . -pa l a aBa i a 

■F ■«!!!■» -1 ■ ■ ■ ■ i ■ ■ | ml miaiii 

• i ' ■ ■ L ‘ mmr- .• i • !■ a - ■ a a - 






takes an algebraic equation on level 2 and an variable on level 1 as 
arguments and returns 1 if the equation is linear for that variable, or 
0 if it is not. For example, 1 H+Y y "2 J 1 H 1 LININ returns 1 because 
the equation is structurally linear for H. See the LININ command in 
chapter 3 for more information. 


Using Conditional Structures and Commands 

Conditional structures let a program make a decision based on the 
results of tests. 

Conditional commands let you execute a true-clause or a false-clause 
(each of which are a single command or object). 

These conditional structures and commands are contained in the PRG 
BRCH menu ((PRG) ll^Bi): 

■ IF ... THEN ... END structure. 

■ IF ... THEN ... ELSE ... END structure. 

■ CASE ... END structure. 

■ I FT (if-then) command. 

■ IFTE (if-then-else) function. 


The IF . .. THEN ... END Structure 


The syntax for this structure is 


III alin 


ill 


test-clause THEM true-clause END 


IF ... THEN ... END executes the sequence of commands in the 
true-clause only if the test-clause evaluates to true. The test-clause 
can be a command sequence (for example, R B -») or an algebraic (for 
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example, 1 fl^B 1 ). If the test-clause is an algebraic, it’s automatically 
evaluated to a number—you don't need —^NUM or EVAL, 

IF begins the test-clause, which leaves a test result on the stack. 
THEN removes the test result from the stack. If the value is nonzero, 
the true-clause is executed—otherwise, program execution resumes 
following END. See “Conditional Examples 1 ’ on page 1-23. 

To enter IF ... THEN ... END in a program: 


Press fpRGl Hllll Q 



* 


The IFT Command 

The IFT command takes two arguments: a test-result in level 2 and a 
true-clause object in level 1. If the test-result is true, the true-clause 
object is executed—otherwise, the two arguments are removed from 
the stack. See “Conditional Examples” on page 1-23. 

To enter IFT in a program: 


Press fPRGl 1«11»! fNEXTl &) SS 


The IF . .. THEN ... ELSE .. END Structure 

The syntax for this structure is 

... IF test-clause 

THEN true-clause ELSE false-clause END ... £• 

IF .,. THEN ... ELSE ... END executes either the true-clause 
sequence of commands if the test-clause is true, or the false-clause 
sequence of commands if the test-clause is false. If the test-clause is an 
algebraic, it’s automatically evaluated to a number—you don’t need 
-^NUM or EVAL. 

IF begins the test-clause, which leaves a test result on the stack. 

THEN removes the test result from the stack. If the value is nonzero, 
the true-clause is executed— otherwise, the false-clause is executed. 
After the appropriate clause is executed, execution resumes following 
END. See “Conditional Examples” on page 1-23. 

To enter IF ... THEN ... ELSE ... END in a program: 


■ Press 


fPRGl mam 
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The IFTE Function 

The algebraic syntax for this function is 

' IFTE (test 9 true-clause* false-clause') 1 

If test evaluates true, the true-clause algebraic is evaluated— 
otherwise, the false-clause algebraic is evaluated. 

You can also use the IFTE function with stack syntax. It takes three 
arguments: a test-result in level 3, a true-clause object in level 2, and 
a false-clause object in level 1. See “Conditional Examples” on page 

1-23. 


To enter IFTE in a program or in an algebraic: 


Press fPRGl lllfflll [NEXT! f+p 

.. 



The CASE ... END Structure 


The syntax for this structure is 


test-clause\ THEN irue-clause i END 
test-clause 2 THEN true-clause 2 END 


test-clause n THEN true-clans e n END 
default-clause (optional) 


END ... 


The CASE ... END structure lets you execute a series of test-clause 
commands, then execute the appropriate irue-clause sequence of 

commands. The first test that returns a true result causes execution of 
the corresponding true-clause, ending the CASE ... END structure. 
Optionally, you can include after the last test a. default-clause that’s 
executed if all the tests evaluate to false. If a test-clause is an 
algebraic, it’s automatically evaluated to a number—you don’t need 
-+NUM or EVAL. 


When CASE is executed, test-clause* is evaluated. If the test is true, 
true-clause* is executed, and execution skips to END. If test-clausei 
is false, execution proceeds to test-clause 2 . Execution within the 
CASE structure continues until a true-clause is executed, or until all 
the test-clauses evaluate to false. If a default clause is included, it’s 
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executed if all the test-clauses evaluate to false. See “Conditional 
Examples 5 below. 


To enter CASE 


* * 


END in a program: 


THEN 


1. Press (PRG) IfiRlMi [♦lliMlillS to enter CASE ... 

-■ - . . ... 

END ... END. 

2. For each additional test-clause, move the cursor after a test-clause 

END and press to enter THEN ... END. 


Conditional Examples 

These examples illustrate conditional structures in programs. 

Example: One Conditional Action. The programs below test the 

value in level 1—if the value is positive, it’s made negative. The first 
program uses a command sequence as the test-clause: 




■. 


11 


DUF IF 8 


THEN NEG 




The value on the stack must be duplicated because the > command 
removes two arguments from the stack (0 and the copy of the value 
made by DUP). 

The following version uses an algebraic as the test clause: 








THEN NEG END 



The following version uses the IFT command: 




D U P 0 





Example: One Conditional Action. This program multiplies two 

numbers if both are nonzero. 
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Program: 



! 





I 


I 




THEN 


V 





Comments: 

Creates local variables x and y 
containing the two numbers from 

the stack. 

Starts the test-clause. 

Tests one of the numbers and 
leaves a test result on the stack. 
Tests the other number, leaving 
another test result on the stack. 
Tests whether both tests were 
true. 

Ends the test-clause, starts the 
true-clause. 

Multiplies the two numbers 
together only if AND returns 
true. 

Ends the true-clause. 


The following program accomplishes the same task as the previous 
program: 


« ■ 

■ i 



IF 



T H E M 



# * 


The test-clause " x AND y 1 returns “true” if both numbers are 
nonzero. 


The following version uses the IFT command: 





,v 



i * 



AND 




in 


■ I 




*> 


y 
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Example: Two Conditional Actions. This program takes a value x 

from the stack and calculates (sin x)/x. At x = 0 the division would 
error, so the program returns the limit value 1 in this case. 


IF 1 1 THEN 


51H 


ELSE i END 


The following version uses IFTE algebraic syntax: 



IFTE 




Example: Two Conditional Actions. This program multiplies two 

numbers together if they 're both nonzero—otherwise, it returns the 
string "ZERO". 


Program: Comments: 



* Hi n2 


IF 

■nl*8 RND n2^@ 1 
THEN 
ni n2 f 

F { i“ r* 

LLOl 

"ZERO 11 
END 


Creates the local variables. 
Starts the defining procedure. 
Starts the test clause. 

Tests nl and n2. 

If both numbers are nonzero, 
multiplies the two values. 

Otherwise, returns the string 

ET O 

ilCK LJ * 

Ends the conditional. 

Ends the defining procedure. 


Programming 1-25 




Example: Two Conditional Actions. This program tests if two 

numbers on the stack have the same value. If so, it drops one of the 
numbers and stores the other in variable VI—otherwise, it stores the 
number from level 1 in VI and the number from level 2 in V2. 


Program: 

■ a 

* 1*1 


Comments: 

%% 

IF 


For the test clause, copies the 

D U P 2 


numbers in levels 1 and 2 and 

SAME 


tests if they have the same value. 

THEN 


For the true clause, drops one of 

DROP 


the numbers and stores the other 

1 VI ' 

STO 

in VI. 

ELSE 


For the false clause, stores the 

1 VI 5 

STO 

level 1 number in VI and the 

III-"! 

ii 

1 u 

S T 0 

level 2 number in V2. 

END 

w 


Ends the conditional structure. 

.V 

[ENTER] 


Puts the program on the stack. 

QTST(sto) 

Stores it in TST . 


Enter the numbers 26 and 52, then execute TST to compare their 
values. Because the two number aren’t equal, the VAR menu now 
contains two new variables VI and V2 . 


26 (ENTER) 52 
(VAR) 1 


ya 

VI 

Tl'T 

TOF;:" 1 ,' 

TOFiSft 


BEEEB 
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Example: Multiple Conditional Actions. The following program 

stores the level 1 argument in a variable if the argument is a string, 
list, or program. 


Program: 


Comments: 


y 


CASE 


y TYPE 

Z SAME 



THEN y 

'STR' S 

JO 

END 

y TYPE 

5 SAME 



THEN y 

'LIST' 

STO 

END 

y TYPE 

8 SAME 



THEN y 

1 PROG 1 

S T 0 

END 


END 


Defines local variable y . 

Starts the defining 
procedure. 

Starts the case structure. 

Case 1: If the argument is 
a string, stores it in STR, 

Case 2: If the argument is 
a list, stores it in LIST . 

Case 3: If the argument is 
a program, stores it in 

PROG . 

Ends the case structure. 

Ends the defining 
procedure. 


Using Loop Structures 

You can use loop structures to execute a part of a program repeatedly. 
To specify in advance how many times to repeat the loop, use a 
definite loop . To use a test to determine whether or not to repeat the 
loop, use an indefinite loop . 


Loop structures let a program execute a sequence of commands several 
times. Loop structures are built with commands—called structure 
words—that work only when used in proper combination with each 
other. These loop structure commands are contained in the PRG 


BRCH menu f fPRGl IHMll): 


■ START ... NEXT and START ... STEP. 

■ FOR ... NEXT and FOR ... STEP. 

■ DO ... UNTIL ... END. 

■ WHILE ... REPEAT ... END. 
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In addition, the S function provides an alternative to definite loop 
structures for summations. 


Using Definite Loop Structures 

Each of the two definite loop structures has two variations: 

■ NEXT. The counter increases by 1 for each loop. 
m STEP, The counter increases or decreases by a specified amount for 
each loop. 


The START ... NEXT Structure 


The syntax for this structure is 


.. start 


START loop-clause NEXT ... $ 


START ... NEXT executes the loop-clause sequence of commands one 
time for each number in the range start to finish. The loop-clause is 
always executed at least once. 


Syntax 


Flowchart 


start 1 :start 

finish 2:finish 



START ... NEXT Structure 
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START takes two numbers (start and finish) from the stack and stores 
them as the starting and ending values for a loop counter. Then, the 
loop-clause is executed. NEXT increments the counter by 1 and tests 
to see if its value is less than or equal to finish. If so, the loop-clause 
is executed again—otherwise, execution resumes following NEXT. 


To enter START 


* • 


NEXT in a program: 


Press fPRGI IftlffisHl ® *1*S®, 

- r . . . ■■■■' - 

Example: The following program creates a list containing 10 copies 


ot the string "ABC 11 * 


* 1 10 START "ABC" NEXT 10 *LI3T * 
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The START ... STEP Structure 

The syntax for this structure is 


* * * 


start finish START loop-clause increment STEP 




START ... STEP executes the loop-clause sequence just like 
START ... NEXT does—except that the program specifies the 
increment value for the counter, rather than incrementing by 1. The 
loop-clause is always executed at least once. 


Syntax 


Flowchart 


start 

finish 

START 


loop-clause 


increment 


STEP 




1 :start 

2:f inish 



1 increment 

I 


counter = counter+ 
increment 

— ; 



START ... STEP Structure 


START takes two numbers (start and finish) from the stack and stores 
them as the starting and ending values of the loop counter. Then 
the loop-clause is executed. STEP takes the increment value from 
the stack and increments the counter by that value. If the argument 


1-30 Programming 





of STEP is an algebraic or a name, it s automatically evaluated to a 
number. 

The increment value can be positive or negative. If it’s positive, the 
loop is executed again if the counter is less than or equal to finish. If 
the increment value is negative, the loop is executed if the counter is 
greater than or equal to finish . Otherwise, execution resumes following 
STEP. In the previous flowchart, the increment value is positive. 


To enter START ... STEP in a program: 


Press fPRGl H 

. 


r.\' 


! I «1>i*■i 

■ | 




1 “ |i—W • 


> * P e r r 


i i iniiiM 
i* * ! ! ! i a i i ■ 


© 


■I??!*.-, I.'-'.'. 



■ i i -i - - 


ij.i I - • * 


IHIlfiM 
> I I I ■ I I i H % i - i - -i-r- 1 


' ■* 


Example: The following program takes a number x from the stack 
and calculates the square of that number several times (x/3 times): 


* DUP 


-** 


1 START x SQ -3 STEP :*■ * 
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The FOR ... NEXT Structure 

The syntax for this structure is 




start finish FOR counter loop-clause NEXT ... 


FOR ... NEXT executes the loop-clause program segment one time 
for each number in the range start to finish , using local variable 
counter as the loop counter. You can use this variable in the 
loop-clause. The loop-clause is always executed at least once. 


Syntax 



start 

finish 

FOR 

loop-clause 


MEXT 




FOR 


1 :start 
2:f inish 

* 




NEXT Structure 


FOR takes start and finish from the stack as the beginning and ending 
values for the loop counter, then creates the local variable counter as a 
loop counter. Then the loop-clause is executed— counter can appear 
within the loop-clause. NEXT increments counter-name by one, and 
then tests whether its value is less than or equal to finish. If so, the 
loop-clause is repeated (with the new value of counter) —otherwise, 
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execution resumes following NEXT, When the loop is exited, counter 

is purged. 


To enter FOR ... NEXT in a program: 




Press fPRGl 


Example: The following program places the squares of the integers 1 
through 5 on the stack: 



1 5 FOR j j SQ NEXT 



Example: The following program takes the value x from the stack 
and computes the integer powers i of x. For example, when x ~ 12 
and start and finish are 3 and 5 respectively, the program returns 12 3 , 
12 4 , and 12 5 , It requires as inputs start and fi,nish in levels 3 and 2, 
and x in level 1 . (+ x removes x from the stack, leaving start and 
finish there as arguments for FOR.) 


■S' 

v- 


FOR n 


n' EVflL NEXT 


:$• 
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The FOR ... STEP Structure 

The syntax for this structure is 




* * 


start finish FOR counter loop-clause increment STEP ... 


FOR ... STEP executes the loop-clause sequence just like FOR ... 
NEXT does—except that the program specifies the increment value 
for counter , rather than incrementing by 1. The loop-clause is always 
executed at least once. 


Syntax 


Flowchart 


start 

finish 

FOR 


loop-clause 


increment 




STEP 


r 





1 :start 
2:finish 



FOR ... STEP Structure 


FOR takes start and finish from the stack as the beginning and ending 
values for the loop counter, then creates the local variable counter as a 
loop counter. Next, the loop-clause is executed— counter can appear 
within the loop-clause. STEP takes the increment value from the 
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stack and increments counter by that value. If the argument of STEP 
is an algebraic or a name, it's automatically evaluated to a number. 

The increment value can be positive or negative. If the increment is 
positive, the loop is executed again if counter is less than or equal to 
finish. If the increment is negative, the loop is executed if counter 
is greater than or equal to finish. Otherwise, counter is purged and 
execution resumes following STEP. In the previous flowchart, the 
increment value is positive. 


To enter FOR 


* * * 


STEP in a program: 


Press fPRGl IfiBBHI ®mill. 

Example: The following program places the squares of the integers 1 
3, 5, 7, and 9 on the stack: 


* 1 9 FOR x x SQ 2 STEP * 


Example: The following program takes n from the stack, and returns 
the series of numbers 1, 2, 4, 8, 16, ... , n. If n isn't in the series, the 
program stops at the last value less than n. 



SWAP FOR n n n STEP 



The first n is the local variable declaration for the FOR loop. The 
second n is put on the stack each iteration of the loop. The third n is 
used by STEP as the step increment. 
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Using Indefinite Loop Structures 

The DO ... UNTIL_END Structure 

The syntax for this structure is 


* * * 


DO loop-clause UNTIL test-clause END 




» 4 


DO . i. UNTIL ... END executes the loop-clause sequence repeatedly 
until test-clause returns a true (nonzero) result. Because the 
test-clause is executed after the loop-clause, the loop-clause is always 
executed at least once. 


Syntax 


Flowchart 


DO 

loop-clause 

UNTIL 

test-clause < 

END 



1:test result 



DO ... UNTIL ... END Structure 


DO starts execution of the loop-clause. UNTIL marks the end of 
the loop-clause. The test-clause leaves a test result on the stack. 

END removes the test result from the stack. If its value is zero, 
the loop-clause is executed again—otherwise, execution resumes 
following END. If the argument of END is an algebraic or a name, it 7 s 
automatically evaluated to a number. 
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To enter DO . . UNTIL ... END in a program: 


Example: The following program calculates n + 2n + 3n+ ... for 
a value ol n> The program stops when the sum exceeds 1000, and 
returns the sum and the coefficient of n. 



Press fPRGj 


Program: 


Comments: 


DUP 1 
n s c 



i 



I NCR 



X. 

■ i 



JNTIL 



1000 






Duplicates n, stores the value into 
n and s, and initializes c to 1. 

Starts the defining procedure. 
Starts the loop-clause. 

Increments the counter by 1. (See 
“Using Loop Counters" on page 

1-39.) 

Calculates c x n and adds the 
product to s. 

Starts the test clause. 

Repeats loop until s > 1000. 

Ends the test-clause. 

Puts s and c on the stack. 

Ends the defining procedure. 
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The WHILE ... REPEAT ... END Structure 

The syntax for this structure is 

■£ ... WHILE test-clause REPEAT loop-clause END ... $■ 

WHILE . i, REPEAT ... END repeatedly evaluates test-clause and 
executes the loop-clause sequence if the test is true. Because the 
test-clause is executed before the loop-clause, the loop-clause is not 
executed if the test is initially false. 


Syntax 


Flowchart 


WHILE 

test-clause 


REPEAT 


loop-clause 

i 

END 



WHILE ... REPEAT ... END Structure 


WHILE starts execution of the test-clause, which returns a test result 
to the stack. REPEAT takes the value from the stack. If the value 
is nonzero, execution continues with the loop-clause—otherwise, 
execution resumes following END. If the argument of REPEAT is an 
algebraic or a name, it’s automatically evaluated to a number. 


TO enter WHILE ... REPEAT ... 

Press fPRGl *111! QHlIl*. 

. -- 


END in a program: 
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Example: The following program starts with a number on the stack, 
and repeatedly performs a division by 2 as long as the result is evenly 
divisible. For example, starting with the number 24, the program 
computes 12, then 6, then 3. 


WHILE Dtlp 




REPEAT 


DUP END 


DROP 



Example: The following program takes any number of vectors 
or arrays from the stack and adds them to the statistics matrix. 

(The vectors and arrays must have the same number of columns.) 

WHILE ... REPEAT ... END is used instead of DO ,.. UNTIL ... 
END because the test must be done before the addition. (If only 
vectors or arrays with the same number of columns are on the stack, 
the program errors after the last vector or array is added to the 
statistics matrix.) 


« WHILE DUP TYPE 3 ===== REPEAT 





Using Loop Counters 

For certain problems you may need a counter inside a loop structure 
to keep track of the number of loops. (This counter isn’t related to the 
counter variable in a FOR ... NEXT/STEP structure.) You can use 
any global or local variable as a counter. You can use the INCR or 
DECR command to increment or decrement the counter value and put 
its new value on the stack. 


The syntax for INCH and DECR is 



* *■ * 


or 



# * * 


1 variable 1 INCR ... » 
1 variable 1 DECR ... 


To enter INCR or DECR in a program: 


Press f4 y|fMEMORY] 111111 



The INCR and DECR commands take a global or local variable name 
(with 1 delimiters) as their argument—the variable must contain a 
real number. The command does the following: 


1. Changes the value stored in the variable by +1 or — 1. 

2. Returns the new value to the stack. 
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Examples: Tf c contains the value 5, then 1 c ' I NCR stores 6 in c 
and returns 6 to the stack* 

The following program takes a maximum of five vectors from the stack 
and adds them to the current statistics matrix. 


Program: 



WHILE 


DUP TYPE 



i 



I NCR 





Comments: 

Stores 0 in local variable c. 

Starts the defining procedure. 
Starts the test clause. 

Returns true if level 1 contains a 

vector. 

Increments and returns the value 
in c. 

Returns true if the counter c < 5. 

Returns true if the two previous 
test results are true. 

Adds the vector to SDAT . 

Ends the structure. 

Ends the defining procedure. 


Using Summations Instead of Loops 

For certain calculations that involve summations, you can use the 
E function instead of loops. You can use E with stack syntax or 

with algebraic syntax. E automatically repeats the addition for the 
specified range of the index variable—without using a loop structure. 

Example: The following programs take an integer upper limit n from 
the stack, then find the summation 

n 

j=1 

One program uses a FOR .,. NEXT loop—the other uses E. 
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Program: 

Comments: 

0 1 ROT 

Initializes the summation and 


puts the limits in place. 

FOR j 

Loops through the calculation. 

.j SQ + 


rh 

X 


Program: 

.v 

Comments: 

v» 

n 

Uses E to calculate the 

i ■>? / 4 — 1 rt 1 

jli J — i H ill J 

summation. 


'V 


Example: The following program uses ELIST to calculate the 
summation of all elements of a vector or matrix. The program takes 
from the stack an array or a name that evaluates to an array, and 
returns the summation. 

Program: C omment s: 


OBJ-* 

1 

H- 



* t 


Finds the dimensions of the array 
and leaves it in a list on level 1. 
Adds 1 to the list. (If the array is 
a vector, the list on level 1 has 
only one element. IILIST will 
error if the list has fewer than two 
elements.) 

Multiplies all of the list elements 
together. 

Converts the array elements into 
a list, and sums them. 
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Using Flags 

You can use flags to control calculator behavior and program 
execution. You can think of a flag as a switch that is either on 
(se^) or off (clear). You can test a flag’s state within a conditional 
or loop structure to make a decision. Because certain flags have 
unique meanings for the calculator, flag tests expand a program’s 
decision-making capabilities beyond that available with comparison 
and logical functions. 


Types of Flags 

The HP 48 has two types of flags: 


■ System flags. Flags —1 through —64. These flags have predefined 

meanings for the calculator. 

■- 

■ User flags. Flags 1 through 64, User flags are not used by any 
built-in operations. What they mean depends entirely on how the 
program uses them. 


Appendix C lists the 64 system flags and their definitions. For 
example, system flag —40 controls the clock display—when this flag 
is clear (the default state), the clock is not displayed—when this 
flag is set, the clock is displayed. (When you press llllllll in the 
(*t)(IV10DES1 llilH menu, you are setting or clearing flag —40.) 


When you set user flag 1 through 5, the corresponding annunciator is 
turned on. Certain plug-in cards may use user-flags in the range 31 
through 64. 


Setting, Clearing, and Testing Flags 

Flag commands take a flag number from the stack—an integer 1 
through 64 (for user flags) or —1 through —64 (for system flags). 

To set, clear, or test a flag: 

1. Enter the flag number (positive or negative). 

2. Execute the flag command—see the table below. 
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Flag Commands 


Key 

Programmable 

Command 

Description 

(PRG | IB 

S*1 [ NXT | [ NXT ] o: 

r (4*i)[M0DES] Ilfiliffil: 

1 II 1 II IJIIJaaaaaaaikl.il 1 I ■ J ■ il J . 1 III 

■ J I 1J J I J - - - - _ i^|^l - L_ _ _ I J . 

i.jiiiijjuAa.B. r _ r - .i.|iii.iii_ 

. . . - ' - ■> -iry-■ ' ■ - - ... 

IlllllllJJa^a.t' t L . L 1. Libia, a. la. 

h 1 • • UJJJJ-- ■ ■ 1 ■■ ■ ■ - ■ - 

SF 

Sets the flag. 

i i ■ l ii"TiT-""i""P"PPri i ri PfPi i i ■ i 

.. " ■ ■ :": rr P liri ... 

■ iiiiiiniinBiifi Mirirriiiiiriiiii 

. . i ■ ■ ■ • ■ - ■ r lf||l ii ri i ■ ■ ri i ■ ■ i 

.J J 1 !■“***" 1 ■■ ■ ■LLIIILIIL1II1 

1 II 1 1 1 1 1 1 Jl | .1 f ■ Alblllbllllllllbl 

1 II 1 1 J J J J l__J___LLI LLIII L I I ■■■ III III 

CF 

Clears the flag. 

1 1 1 J I 1 1 fj^M . k I L f ■ 1 11 1 1 1 1 1 1 1 1 1 

■ II I II I lljj JI..I..L. . Ill 1 . 1 1 II III II 

■ 411.11 MM - -J AAA ■ ■ ■ > ■ .. hi. 

.■ ■« -|-- J " ■ ... 

. . . ijj| - -riij-l-riiiirii 

FS? 

Returns 1 (true) if the flag is set, or 0 
(false) if the flag is clear. 

. |BW' 1 ■ 1 . 

.....a.H. rrrr B|I ^ 1 ^ I 1 . I— II 111 I 

■ P* f r r ■ pin ■■■ ■ ■ | i m ■ ■ ■ ■■ 

....... fepp pi ■.II .. 

• — r - — - - nkr r i i i i ki ■■■■■■ i A ■■ i ■■■■■■ ■ 

■ r - - - p - ■ i - pi ■ | i ■ | ■■■■■■■■■■■■■■■ 
l ■ l ■ ■ l * rpi ■ ppi i i |M> i i i .. 

FC? 

Returns 1 (true) if the flag is clear, or 0 
(false) if the flag is set. 

-jj-j - - -- i 

FS?C 

Tests the flag (returns true if the flag is 
set), then clears the flag. 

.. i i ■ ii , mimiii ,,,, p 

.PPP'rrHi. . ■ 1«|” 

I.| rl i 1 1 '■' ( ' ( " 1 1 - 1 ■ - ■ 

’ j V- 

■ “ “ “ “ “ “ r -■ ppi i ■ ■ i i | i ■ ■ -•■■■■■ r ■ ■ ri 

-- A P---I ft. Ill 1 1 1 1 1 1 j ■ |ii| .. ■ 4 L 

1 “ “ ’“A” - ■ ■ r 1 ■ Hi PI 1 t| 1 j 4 ■ .AAV" 4 L ■ ■ 1 

|-1...-rrpi 1 r I I I I I I 4 I IJJ4.J..J4.I LLL 

4inn...rpp.i ■ iiii 14 iiIJ1-J---.---L-. 

FC?C 

Tests the flag (returns true if the flag is 
clear), then clears the flag. 


Example: System Flag. The following program sets an alarm for 
June 6, 1993 at 5:05 PM. It first tests the status of system flag —42 
(Date Format flag) in a conditional structure and then supplies the 
alarm date in the current date format, based on the test result. 


Program: 



oments: 


■. 


IF 

-42 FC? 

THEN 

6.151993 
EL 3 E 

15.861993 


END 

17.85 “TEST COMPLETE" 
3 *LIST STORLBRM 



Tests the status of flag —42, the 
Date Format flag. 

If flag —42 is clear, supplies the 
date in month/day/year format. 

If flag —42 is set, supplies the 
date in day.month, year format. 

Ends the conditional. 

Sets the alarm: 17.05 is the alarm 
time and “TEST COMPLETE” 
is the alarm message. 


Example: User Flag. The following program returns either the 

fractional or integer part of the number in level 1, depending on the 
state of user flag 10. 
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Program: 


Comments; 


IF 

1@ FS? 
THEN 
IP 

ELSE 



Starts the conditional. 

Tests the status of user flag 10. 

If flag 10 is set, returns the 
integer part. 

If flag 10 is clear, returns the 
fractional part. 

Ends the conditional. 


To use this program, you enter a number, either set flag 10 (to get the 
integer part) or clear flag 10 (to get the fractional part), then run the 
program. 


Recalling and Storing the Flag States 

If you have a program that changes the state of a flag during 
execution, you may want it to save and restore original flag states. 

The RCLF (recall flags) and STOP (store flags) commands let you 
recall and store the states of the HP 48 flags. For these commands, 
a 64-bit binary integer represents the states of 64 flags—each 0 bit 
corresponds to a flag that’s clear, each 1 bit corresponds to a flag 
that’s set. The rightmost (least significant) bit corresponds to system 
flag — 1 or user flag 1. 


To recall the current flag states: 


Execute RCLF (|>t K MODES ) f NXT1 1K1B111). 


RCLF returns a list containing two 64-bit binary integers representing 
the current states of the system and user flags: 



# n s # n u > 


To change the current flag states: 


1. Enter the flag-state argument 

2. Execute STOF ( f*T)(MODES) 


see below. 
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STOF sets the current states of flags based on the flag-state argument: 

#n s Changes the states of only the system flags. 

■C #n s #n u > Changes the states of the system and user flags. 

Example: The program PRESERVE on page 2-8 uses RCLF and 
STOF. 


Using Subroutines 

Because a program is itself an object, it can be used in another 
program as a subroutine. When program B is used by program 
A. program A calls program S, and program B is a subroutine in 
program A. 

Example: The program TORS A calculates the surface area of a torus 
of inner radius a and outer radius b. TORS A is used as a subroutine 
in a second program TORSV ) which calculates the volume of a torus. 



The surface area and volume are calculated by 

A = 7t 2 (6 2 — a 2 ) V — ^7t 2 (6 2 — a 2 )(b — a) 

(The quantity tt 2 (6 2 - a 2 ) in the second equation is the surface area of 
a torus calculated by TORS A.) 
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Here are the stack diagram and program listing for TORS A, 


Level 2 

Level 1 

■* Level 1 

a 

b 

■+ surface area 


Program: 


Comments: 



I 





Creates local variables a and b. 
Calculates the surface area. 
Converts algebraic to a number. 


(ENTER) 

0 TGRSA fSTOl 


Puts the program on the stack. 
Stores the program in TORS A. 


Here is a stack diagram and program listing for TORS V. 


Level 2 

Level 1 

-* 

Level 1 

a 

b 

- 

volume 


Program: 




b TOR SR 



(enter! 

0 TORSV (STQl 


Comments: 

Creates local variables a and b. 

Starts a program as the defining 
procedure. 

Puts the numbers stored in a and 
b on the stack, then calls TORS A 
with those arguments. 

Completes the volume calculation 
using the surface area. 

Ends the defining procedure. 

Puts the program on the stack. 
Stores the program in TORSV. 
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Now use TORSV to calculate the volume of a torus of inner radius 
a ~ 6 and outer radius 6 = 8. 


6 fENTER1 8 

■ ■■«.- -a - i *. i h ■ ■ ij >j ■ j j j j * 


1 * 138.174461616 


TDF;SV TDFi.'rt Y2 



j'PHLV 



Single-Stepping through a Program 

It’s easier to understand how a program works if you execute it step 
by step, observing the effect of each step. Doing this can help you 
debug your own programs or understand programs written by others. 


To single-step from the start of a program: 

1. Put the program or program name in level 1 (or the command 
line). 

2. Press fPRG][NXT] SttHH IBBBH to start and immediately 

... . V 


suspend execution. 

HALT appears in the status area. 

3. Take any action: 

To see the next program step displayed in the status area and 


*■ KJL' J 1 * fc UJJ * f triJLUJ n ■ m ■ r 


then executed, press IliSIH. 


To display but not execute the next one or two program steps 


press wmm?w 

■rife -a niiftr*rrr*rT"ffifi ifr»p a ■ s. i n ■ 


l;t. 


To continue with normal execution, press f^i rcoKm . 
To abandon further execution, press IJlIjlJlJl. 

4. Repeat the previous step as desired. 


To turn off the HALT annunciator at any time: 


Press [PRGJ(NXT) lillillll ISiili. 

. 


Example: Execute program TORSV step by step. Use a = 6 and 
6 = 8 . 
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Select the VAR menu and enter the data. Enter the program name 
and start the debugging. HALT indicates program execution is 
suspended. 



Display and execute the first program step. Notice that it takes the 
two arguments from the stack and stored them in local variables a and 
6 . 



Continue single-stepping until the status area shows the current 
directory. Watch the stack and status area as you single-step through 


the program. 



To single-step from the middle of a program: 

1. Insert a HALT command in the program where you want to begin 
single-stepping. 

2. Execute the program normally. The program stops when the HALT 


command is executed, and the 


-Mil ■ ■■■■■ 


annunciator appears. 


3. Take any action: 


To see the next program step displayed in the status area and 
then executed, press IlSiliil- 


To display but not execute the next one or two program steps, 
press liilil. 

To continue with normal execution, press f+ilfCQNT) . 

To abandon further execution, press 


4. Repeat the previous step as desired. 
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When you want the program to run normally again, remove the HALT 
command from the program. 


To single-step when the next step is a subroutine: 


f! f«.! Ill i l I 1 I ■ ■ - i ■ - 1 ! 

p ir| “> ■a -■ — I I i-ia'-.JJ 

L L L . I!i1 1 ppp | — ------ 

ill. i . ill la a ■ t i* i|in - «■■■■---—- 

- a fin 1 it- - I -- - - 


To execute the subroutine in one step, press 
To execute the subroutine step-by-step, press HHlil* 


\tv>l 

e | iif ■ |ii | d . . 

! I ■ r ■ ■ ■ 


« • ! I 1 a a a a p 


B|| executes the next step in a program—if the next step is a 

HI® executes the subroutine in one step. IlllSlil 

■ ! I ll III • I I I 1 I i B 1 a J ■■■■■■■■■■■■■ IBLLB-Bki.L-J.BPBI ■■ BP 


■ an i I ■ «i B J* r a i 


except if the next program step is a 


subroutine, 
works just like 

subroutine, it single-steps to the first step in the subroutine. 
Example: In the previous example, you used IliliBHS to execute 

O' JL / V I I i I I I I I I I I I i-li l> - i-M-i-i 

subroutine TORS A in one step. Now execute program TORSV step 
by step to calculate the volume of a torus of radii a ~ 10 and b — 12 
When you reach subroutine TORS A, execute it step by step. 


Select the VAR menu and enter the data. Enter the program name 
and start the debugging. Execute the first four steps of the program, 
then check the next step. 


f^TKCLEAR) fVAR) 
10 (ENTER) 12 




n in 

■Illiirfiilaaiiil 

111111(1 I | | 1 !1(J ... 

fpRGl fNxn illliil 




HI M M M H ' 


i I e i a i s t M 


#■ 


(4 times) 





The next step is T0R8R. Single-step into TORS A, then check that 
you’re at the first step of TORS A. 



+ a 



Press f^l fCQNTi r^lfco NT ) to complete subroutine and program 
execution. 

The following table summarizes the operations for single-stepping 
through a program. 
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Single-Step Operations 


Key 

P rogrammable 
Command 

Description 

BB 

■ 1 n 1 ■ 1 1 ■ 1 1 n 1 1 ■■ 1 j j 1 it ■ ■■ 1 ■ 

rriiiiiiii 1 1 1 ■■■ ■■ 11 1 11 1 j 1 1 11 1 11 1 id 


IIBI1I 

■ 

Starts program execution, then 
suspends it as if HALT were the first 
program command. Takes as its 
argument the program or program 
name in level 1 . 

l .■###■■ ■ '■■■■■. 

P " L P - - M 1 1 f 1 M II | III I 1 J 1 I I 1 1 1 1 1 

1 1 1 IJJfl 1 1 1 II ■ ill ■■ ■ ■■ ■ ■■ ■ 

' ■ ■ - J ■ ■ ■ Ml ■ ■ ■ ■ 1. 

- _ ___iiiii 4 iiiiiiMiijihijiiiiiiii 

f n 1 | 1 | Mil 

r” 1 , ' ' ^ 1 * 1*1 ' 1' 1' 1"* 1'I™1 , | , | , |"*| , | , |"i'« , | , | 

IkI.IJ.JJJIMJIIJJIIIJIIMMMMIM 


Executes the next object or command 
in the suspended program. 



Same as except it the next 

program step is a subroutine, 
single-steps to the first step in that 
subroutine. 

liiiiii 


Displays the next one or two objects, 
but does not execute them. The display 
persists until the next keystroke. 

1 SKln* '■ 8 1 ittT 8 n S * 1 ^ > alBnR i 

fflfcJW' nni JU1 I J | • -, . 

HALT 

Suspends program execution at the 
location of the HALT command in the 
program. 

'.■.V.'f?* '.'I 

dfl- i i-ta ■ ■ 1 ' ■ -iMa ■ ■ fekBH ■ ■ ■ ■ ■ 

KILL 

Cancels all suspended programs and 
turns off the HfiLT annunciator. 

(◄tI(CONT) 

CONT 

Resumes execution of a halted program. 


Trapping Errors 

If you attempt an invalid operation from the keyboard, the operation 
is not executed and an error message appears. For example, if you 
execute + with a vector and a real number on the stack, the HP 48 
returns the message + Error" Bad fir 9 uni erst Type and returns the 
arguments to the stack (if Last Arguments is enabled). 


In a program, the same thing happens, but program execution is also 
aborted. If you anticipate error conditions, your program can process 
them without interrupting execution. 
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For simple programs, you can run the program again if it stops with 
an error. For other programs, you can design them to imp errors and 
continue executing. You can also create user-defined errors to trap 
certain conditions in programs. The error trapping commands are 
located in the PRG ERROR menu. 

Causing and Analyzing Errors 

Many conditions are automatically recognized by the HP 48 as error 
conditions—and they’re automatically treated as errors in programs. 

You can also define conditions that cause errors. You can cause a 
user-defined error (with a user-defined error message)—or you can 
cause a built-in error. Normally, you’ll include a conditional or loop 
structure with a test for the error condition—and if it occurs, you’ll 
cause the user-defined or built-in error to occur. 

To cause a user-defined error to occur in a program: 

1. Enter a string (with !i " delimiters) containing the desired error 
message. 

2. Enter the DOERR command (PRG ERROR menu). 

To artificially cause a built-in error to occur in a program: 

1. Enter the error number (as a binary integer or real number) for the 
error. 

2. Enter the DOERR command (PRG ERROR menu). 

If DOERR is trapped in an IFERR structure (described in the next 
topic), execution continues. If it’s not trapped, execution is abandoned 
at the DOERR command and the error message appears. 

To analyze an error in a program: 

■ To get the error number for the last error, execute ERRN (PRG 
ERROR menu). 

■ To get the error message for the last error, execute ERRM (PRG 
ERROR menu). 

■ To clear the last-error information, execute ERRO (PRG ERROR 
menu). 

The error number for a user-defined error is #70000h. See the list of 
built-in error numbers in appendix A, Error and Status Messages.” 
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Example: The following program aborts execution if the list in level 
1 contains three objects. 


A * 



: i 



91 


OBJECTS IN LIST 1 ' DOERR 



V 


»V 


The following table summarizes error trapping commands. 


Error Trapping Commands 


Key 

P r ogr ammable 
Command 

Description 



r r r i ¥ I- »■ h i ■ *■ ► »■»■*■ »■ »■ hi h r ¥ r rmr ■ i r r ■ r ■ ■. - 

w UiiRR 

•I' 11 1,1 .. j a « - ■ ■-l-- l.b 

1 ! 1 1 ■ f ■ ■ ■ 1 ■■■■■■■■aaBBEaaaaaa-- 

DOERR 

Causes an error. For a string in level 1, 
causes a user-defined error: the 
calculator behaves just as if an 
ordinary error has occurred. For a 
binary integer or real number in level 1, 
causes the corresponding built-in error. 

If the error isn’t trapped in an IF ERR 
structure 3 DOERR displays the 
message and abandons program 
execution. (For 0 in level 1, abandons 
execution without updating the error 
number or message—like (CANCEL).) 

r ■ e ■ i. . 1 1,1 1 1 i i i 1. i ' * i- ■ ‘ --r ■ 

isiiii 

ERRN 

Returns the error number, as a binary 
integer, of the most recent error. 

Returns #0 if the error number was 
cleared by ERRO. 

; R R hi 

■ ' IklkU ■ lJLl-1 1 - ■ '■. 

• ■ r ! 1 ! i ! 8 1 1 1 i 1 1 • ■ 1 ■ ! 1 1 i . . 

ERRM 

Returns the error message (a string) for 
the most recent error. Returns an 
empty string if the error number was 
cleared by ERRO. 

3 —— ■ ■'**** • ' ■ J ■ 

ERRO 

Clears the last error number and 
message. 
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Making an Error Trap 

You can construct an error trap with one of the following conditional 
structures: 

■ HIRE ... THEN ... END. 
m IFERIL ... THEN ... ELSE ... END. 

The IFERR ... THEN ... END Structure 

The syntax for this structure is 

« ... IFERR trap-clause THEN error-clause END ... p 

The commands in the error-clause are executed only if an error is 
generated during execution of the trap-clause. If an error occurs in the 
trap-clause, the error is ignored, the remainder of the trap-clause is 
skipped, and program execution jumps to the error-clause. If no errors 
occur in the trap-clause, the error-clause is skipped and execution 
resumes after the END command. 


To enter IFERR ... THEN ... END in a program: 


Press fPRG ] fNXT ] lf|§i|f f^p lEEll 


Example: The following program takes any number of vectors 
or arrays from the stack and adds them to the statistics matrix. 
However, the program stops with an error if a vector or array with 
a different number of columns is encountered. In addition, if only 
vectors or arrays with the same number of columns are on the stack, 
the program stops with an error after the last vector or array has been 
removed from the stack. 



WHILE DUP TYPE 






In the following revised version, the program simply attempts to add 
the level 1 object to the statistics matrix until an error occurs. Then, 

it ends by displaying the message DONE. 
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Program: 


Comments: 


IFERR 

MHILE 



E H D 
THEN 

"DONE 11 1 DISP 
I FREEZE 



Starts the trap-clause. 

The WHILE structure repeats 
indefinitely, adding the vectors 
and arrays to the statistics matrix 
until an error occurs. 


Starts the error clause. If an error 
occurs in the WHILE structure, 
displays the message DONE in the 
status area. 

Ends the error structure. 


The IFERR .. THEN . . ELSE ... END Structure 

The syntax for this structure is 

■ft ... IFERR trap-clause 

THEN error-clause ELSE normal-clause END ... 

The commands in the error-clause are executed only if an error is 
generated during execution of the trap-clause. If an error occurs in the 
trap-clause, the error is ignored, the remainder of the trap-clause is 
skipped, and program execution jumps to the error-clause. If no errors 
occur in the trap-clause, execution jumps to the normal-clause at the 
completion of the trap-clause. 


To enter IFERR 


THEN 



END in a program: 


■ Press 



(prg)(nxt) 


Example: The following program prompts for two numbers, then 
adds them. If only one number is supplied, the program displays an 
error message and prompts again. 
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Comments: 


Program: 


D 0 


11 KEY IN a 
INPUT OBJ 
UNTIL 
IFERR 


+ 

THEN 






> b 1 


I II H 


d WRIT 
0 


DISP 


ELSE 

1 

END 

END 


:&■ 


Begins the main loop. 
Prompts for two numbers. 


Starts the loop test clause. 

The error trap contains only the 
+ command. 

If an error occurs, recalls and 
displays the Too Few 
Argument s message for 2 
seconds, then puts 0 (false) on 
the stack for the main loop. 

If no error occurs, puts 1 (true) 
on the stack for the main loop. 

Ends the error trap. 

Ends the main loop. If the error 
trap left 0 (false) on the stack, 
the main loop repeats—otherwise, 
the program ends. 


Input 

A program can stop for user input, then resume execution, or can use 
choose boxes or input forms (dialog boxes) for input. You can use 
several commands to get input: 

■ PROMPT ( f+PfCONT 1 to resume). 

■ DISP FREEZE HALT ( Q(CONT) to resume). 

■ INPUT ( [ENTER) to resume), 

■ INFORM 

■ CHOOSE 
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Data Input Commands 


Key 

Command 

Description 

|iaHapsB| 

.HI - i -- - i 

i r-1 : 

. - -■■■" - ■■■--!. ■ 


mmm 

INFORM 

Creates a user-defined input form. 

-■-- - HI - • -1 • • ' ■ - • - - • • • •• 

— a - - ■ •• ■. 

P4 i 1 'I.:' hi 

• - - • i- • • PM • • • - # * P • • • • ■ • • ■*.1. Y. 

NOVAL 

Place holder for the INFORM 
command. Returned when a value is 
not present in an input form field. 

: H i ^ 

■ ■ ■■■ i > i H • • • 1 • • • *111 ■ ■ -***-- ■ 

CHOOSE 

Creates a user-defined choose box. 


KEY 

Returns a test result to level 1 and, if a 
key is pressed, the location of that key 
(level 2). 

.■ ■ ■ iU • • ■ UHIH 1 ■ ■ ■ ■ 

WAIT 

Suspends program execution for a 
specified duration (in seconds, level 1). 

. . ■■■ -■■■■- - - ■ V- - 

INPUT 

Suspends program execution tor data 
input. 


PROMPT 

Halts program execution for data input. 


Using PROMPT ... CONT for Input 

PROMPT uses the status area for prompting, and allows the user to 
use normal keyboard operations during input. 


To enter PROMPT in a program: 


1. Enter a string (with 11 11 delimiters) to be displayed as a prompt in 
the status area. 

2. Enter the PROMPT command (PRG IN menu). 



li prompt-string 1 ' 



* * 



PROMPT takes a string argument from level 1, displays the string 
(without the " " delimiters) in the status area, and halts program 
execution. Calculator control is returned to the keyboard. 

When execution resumes, the input is left on the stack as entered. 


To respond to PROMPT while running a program: 

1. Enter your input—you can use keyboard operations to calculate the 
input. 
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2. Press Q(CONT) . 


The message remains until you press [ENTER) or [CANCEL ) or until you 

update the status area. 

Example: If you execute this program segment 


it 


RBC?" PROMPT * 


the display looks like this: 


RBC? 

4 : 

3 : 

2 s 

1* 


P F; □ M 


Example: The following program, TP ROMFT , prompts you for the 
dimensions of a torus, then calls program TORS A (from page 1-45) to 
calculate its surface area. You don’t have to enter data on the stack 
prior to program execution. 

Program: Comments: 


n ENTER a, b IN ORDER 


B M 

H 


PROMPT 


i URSH 


& 


(ENTER) Q TPROMPT fsTol 


Puts the prompting string on the 
stack. 

Displays the string in the status 
area, halts program execution, 
and returns calculator control to 
the keyboard. 

Executes TORS A using the 

just-entered stack arguments. 
Stores the program in 

TPROMPT . 


Execute TPROMPT to calculate the volume of a torus with inner 
radius a — 8 and outer radius 6—10. 
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Execute TPROMPT. The program prompts you for data. 



Enter the inner and outer radii. After you press (ENTER] , the prompt 
message is cleared from the status area. 



Note that when program execution is suspended by PROMPT, you 
can execute calculator operations just as you did before you started 
the program. If the outer radius b of the torus in the previous 
example is measured as 0.83 feet, you can convert that value to inches 
while the program is suspended for data input by pressing .83 (ENTER) 
12 then f^Tl t CONTI . 

Using DISP FREEZE HALT ... CONT for Input 

DISP FREEZE HALT lets you control the entire display during input, 
and allows the user to use normal keyboard operations during input. 

To enter DISP FREEZE HALT in a program: 

1. Enter a string or other object to be displayed as a prompt. 

2. Enter a number specifying the line to display it on. 

3. Enter the DISP command (PRG OUT menu). 

4. Enter a number specifying the areas of the display to ‘'freeze.” 

5. Enter the FREEZE command (PRG OUT menu). 

6. Enter the HALT command (PRG OUT menu). 
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<8£ ... prompt-object display-line DISP 

freeze-area FREEZE HRLT ... 

DISP displays an object in a specified line of the display. DISP 
takes two arguments from the stack: an object from level 2, and a 
display-line number 1 through 7 from level 1. If the object is a string, 
it’s displayed without the 11 n delimiters. The display created by 
DISP persists only as long as the program continues execution—if the 
program ends or is suspended by HALT, the calculator returns to the 
normal stack environment and updates the display. However, you can 
use FREEZE to retain the prompt display. 

FREEZE “freezes” display areas so they aren't updated until a key 
press. Argument n in level 1 is the sum of the codes for the areas to 
be frozen: 1 for the status area, 2 for the stack/command line area, 4 
for the menu area. 

HALT suspends program execution at the location of the HALT 
command and turns on the HRLT annunciator. Calculator control is 
returned to the keyboard for normal operations. 

When execution resumes, the input remains on the stack as entered. 


To respond to HALT while running a program: 

1. Enter your input—you can use keyboard operations to calculate the 
input. 

2. Press f^nfCONTl . 

Example: If you execute this program segment 


■£ !, RBC»DEFsGHI 11 CL LCD 1 DISP 


rrSCtit 


HALT 



the display looks like this: 



(The m in the previous program is the calculator's representation for 
the ^ newline character after you enter a program on the stack.) 
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Using INPUT ... ENTER for Input 

INPUT lets you use the stack area for prompting, lets you supply 
default input, and prevents the user from using normal stack 
operations or altering data on the stack. 


To enter INPUT in a program: 

1. Enter a string (with 1 Si delimiters) to be displayed as a prompt at 
the top of the stack area. 

2. Enter a string or list (with delimiters) that specifies the 
command-line content and behavior—see below. 

3. Enter the INPUT command (PRG IN menu). 

4. Enter OBJ—► (PRG TYPE menu) or other command that processes 
the input as a string object. 



* *■ * 


or 



u prompt-string 11 


M command-line n INPU1 



n prompt-string 11 


i command-line"} INPUT OBJ* 




INPUT, in its simplest form, takes two strings as arguments—see the 
list of additional options following. INPUT blanks the stack area, 
displays the contents of the level-2 string at the top of the stack area, 
and displays the contents of the level-1 string in the command line. It 
then activates Program-entry mode, puts the insert cursor after the 
string in the command line, and suspends execution. 


When execution resumes, the input is returned to level 1 as a string 
object, called the result string . 


To respond to INPUT while running a program: 

1. Enter your input. (You can’t execute commands—they’re simply 


2 . 


echoed in the command line.) 

Optional: To clear the command line and start over, press 
f CANCEL 1 . 


3. Press (ENTER 1 . 


Example: If you execute this program segment 


fe h 


" Variateie nane?" »:VRR s" INFU7 


the display looks like this: 
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i HOME l _ 

Variable name? 





INFDF; 




INPUT KEV 



Example: The following program, VSPH . calculates the volume of a 
sphere. VS PH prompts for the radius of the sphere, then cubes it and 
multiplies by 4 f$ ir. VS PH executes INPUT to prompt for the radius. 
INPUT sets Program-entry mode when program execution pauses for 
data entry. 


Program: 


Comments: 



II II 


in radius" 


INPUT 




(ENTER] Q VSPH fSTOl 


Specifies the prompt string. 

Specifies the command-line string. 
In this case, the command line 
will be empty. 

Displays the prompt, puts the 
cursor at the start of the 
command line, and suspends the 
program for data input (the 
radius of the sphere). 

Converts the result string into its 
component object—a real 
number. 

Cubes the radius. 

Completes the calculation. 

Stores the program in VSPH. 
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Execute VS PH to calculate the volume of a sphere of radius 2.5. 



To include INPUT options: 

■ Use a list (with £ > delimiters) as the command-line argument for 
INPUT. The list can contain one or more of the following: 
p Command-line string (with 18 “ delimiters), 
n Cursor position as a real number or as a list containing two real 
numbers. 

□ Operating options RLG, o:, or V. 

In its general form, the level 1 argument for INPUT is a list that 
specifies the content and interpretation of the command line. The list 
can contain one or more of the following parameters in any order: 

£ " command-line" cursor-position operating-options } 

11 command-line " Specifies the content of the command line 

when the program pauses. Embedded newline 
characters produce multiple lines in the display. 
(If not included, the command line is blank.) 

cursor-position Specifies the position of the cursor in the 

command line and its type. (If not included, an 
insert cursor is at the end of the command line,) 

■ A real number n specifies the nth character in 
the first row (line) of the command line. Zero 
specifies the end of the command-line string. A 
positive number specifies the insert cursor—a 
negative number specifies the replace cursor. 

■ A list £ row character specifies the row and 
character position. Row 1 is the first row (line) 
of the command line. Characters count from 
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the left end of each row—character 0 specifies 
the end of the row. A positive row number 
specifies the insert cursor—a negative row 
number specifies the replace cursor. 

operating-options Specify the input setup and processing using zero 

or more of these unquoted names: 

■ HLG activates Algebraic/Program-entry mode 
(for algebraic syntax). (If not included, 
Program-entry mode is active.) 

■ « ( (a) (S®) specifies alpha lock, (If not 
included, alpha is inactive.) 

■ V verifies whether the result string (without the 
“ " delimiters) is a valid object or sequence of 
objects. If the result string isn’t valid, INPUT 
displays the Invalid Syntax message and 
prompts again for data. (If not included, syntax 
isn’t checked.) 

To design the command-line string for INPUT: 

■ For simple input, use a string that produces a valid object: 

□ Use an empty string. 

□ Use a s label” tag. 

□ Use a &text&i comment. 

■ For special input, use a string that produces a recognizable pattern. 

After the user enters input in the command line and presses [ENTER] 
to resume execution, the contents of the command line are returned 
to level 1 as the result string. The result string normally contains the 
original command-line string, too. If you design the command-line 
string carefully, you can ease the process of extracting the input data. 

To process the result string from INPUT: 

■ For simple input, use OBJ—* to convert the string into its 
corresponding objects. 

■ For sensitive input, use the V option for INPUT to check for valid 
objects, then use OBJ^ to convert the string into those objects. 

■ For special input, process the input as a string object, possibly 
extracting data as substrings. 
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Example; The program VS PH on page 1-61 uses an empty 
command-line string. 

Example: Tile program SSEC on page 1-66 uses a command-line 
string whose characters form a pattern. The program extracts 
substrings from the result string. 


Example: The command-line string "SUPPER LI MI F@" displays 
SUPPER: LIMITS# in the command line. If you press 200 [ENTER] , 
the return string is "SUPPER LIMITS200 11 . When OBJ-» extracts 


the text from the string, it strips away the @ characters and the 
enclosed characters, and it returns the number 200. (See “Creating 
Programs on a Computer" on page 1-10 for more information about 
comments.) 



Example: The following program, TINPUT , executes INPUT to 
prompt for the inner and outer radii of a torus, then calls TORS A 
(page 1-45) to calculate its surface area. TIN PUT prompts for a and 
b in a two-row command line. The level 1 argument for INPUT is a 
list that contains: 


■ The command-line string, which forms the tags and delimiters for 

two tagged objects. 

■ An embedded list specifying the initial cursor position. 

■ The V parameter to check for invalid syntax in the result string. 
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Comments: 


Program: 



in 




II 



IE tt 

B 



« n L, h IE 
n n 





IIPUT 


U B *J 

TOR 3ft 


The level 2 string, displayed at 
the top of the stack area. 

The level 1 list contains a string, 
a list, and the verify option. (To 
key in the string, press ?T 1 

(30 a © ©(© ©ClD k. 

After you press fENTEiC) to put 
the finished program on the stack, 
the string is shown on one line, 
with ■ indicating the newline 
character.) The embedded list 
puts the insert cursor at the end 
of row 1. 

Displays the stack and 
command-line strings, positions 
the cursor, sets Program-entry 
mode, and suspends execution for 
input. 

Converts the string into its 
component objects—two tagged 
objects. 

Calls TORS A to calculate the 
surface area. 


[ENTER] CD TINPUT fSTOl Stores the program in TINPUT. 


Execute TINP (IT to calculate the surface area of a torus of inner 
radius a = 10 and outer radius b — 20. 




r home > _ 

Key in a? b 




= b- 


TINPU 

VS PH 

TPF; 

n 

TDFlSV 

TQFlSH 

va 
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Key in the value for a , press m to move the cursor to the next 
prompt, then key in the value for b. 


10 © 20 


Continue program execution. 


I HOME l _ 

Key in a* b 




:a:10 

: b= 20 


TINPU 

MSPH : 

TPF; 

0 

T0F;SM 

TOfiSH 

M2 


[enter! 


Is 2960.88132033 


TINPU MS PH TPF;D TOBSM TDRSfi M2 


Example: The following program executes INPUT to prompt for a 
social security number, then extracts two strings: the first three digits 
and last four digits. The level 1 argument for INPUT specifies: 

■ A command-line string with dashes. 

■ The replace cursor positioned at the start of the prompt string (—1). 
This lets the user “fill in the command line string, using © to skip 
over the dashes in the pattern. 

■ By default, no verification of object syntax—the dashes make the 
content invalid as objects. 


Level 1 

-> Level 2 

Level 1 

— 

" last four digits' 

" first three digitsf 
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Comments: 


Program: 





INPUT 

DUP 1 3 SUB 
SWAP 

8 11 SUB 

( ENTER 1 Q SSEC fSTO] 


Prompt string. 

Command-line string (3 spaces 
before the first 2 spaces 
between, and 4 spaces after the 
last -). 

Suspends the program for input. 

Copies the result string, then 
extracts the first three and last 
four digits in string form. 


Stores the program in SSEC . 


Using INFORM and CHOOSE for Input 

You can use input forms (dialog boxes), and choose boxes for program 
input. Programs that contain input forms or choose boxes wait until 
you acknowledge them (lliilfili or [CANCEL]) before they continue 

mf ffj \ t (mill 111.1 ■ «• m ■ » • • « ■ r r i n_J ■ ■ ■ ■ ■ r p / ■/ 

execution. 


If OK is pressed, CHOOSE returns the selected item (or its designated 
returned value) to level 2 and a 1 to level 1. INFORM returns a list of 
field values to level 2 and a 1 to level 1. 

Both the INFORM and CHOOSE commands return 0 if CANCEL is 
pressed. 





I). 


To set up an input form: 

1. Enter a title string for the input form (use 

2. Enter a list of field specifications. 

3. Enter a list of format options, 

4. Enter a list of reset values (values that appear when BiHlHi is 
pressed). 

5. Enter a list of default values. 

6. Execute the INFORM command. 


Example: Enter a title “FIRST ONE" [ENTER 1 . 

Specify a field C “Hane* " } [ENTER] , 

Enter format options (one column, tabs stop width five) C 1 5 > 
[ENTER] . 
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Enter reset value for the field C "THERESA" > ( ENTERj . 
Enter default value for the field € "WENDY" > fENTER 1 . 


Execute INFORM ((PRG)(NXTl■SNfS INI- OR). 

The screen on the left appears. Press (NXT ] fllllB Itlllllll and the 
screen on the right appears. 




You can specify a help message and the type of data that must be 
entered in a field by entering field specifications as lists. For example. 


y n Ej iv, a ■ i* 

■ i'! -dil 1 1 1 ■ 


“Enter your nane“ 2> > defines the Name field, 


displays Enter your name across the bottom of the input form, and 
accepts only object type 2 (strings) as input. 


To set up a choose box: 

1. Enter a title string for the choose box. 

2. Enter a list of items. If this is a list of two-element lists, the first 
element is displayed in the choose box, and the second element is 
returned to level 2 when OK is pressed. 

3. Enter a position number for the default highlighted item. (0 makes 
a view-only choose box.) 

4. Execute the CHOOSE command. 



Example: Enter a title "FIRST ONE" 

Enter a list of items C ONE TWO THREE > (ENTER) . 
Enter a position number for default highlighted value 

Execute CHOOSE ( fPRGl (NXT) IBIB SI^Bi)* 
The following choose box appears: 


(ENTER) . 
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< HO 


4: 

3: 

2s 

Is 


FIRST ONE 


ONE 

TWO 


THREE 


NE" 
E ) 
3 



CANtLl DK 


Example: The following program uses input forms, choose boxes, and 
message boxes to create a simple phone list database. 


Program: 


Comments: 


NAMES ' V'TTPE 


IF -I 
THEN { 
END 
WHILE 


Mdri ii—MA 


NAMES' STO 


u rr t 


PHONELIST OPTIONSS 


II 


" BDD R NRME" 1> 


II u 


/1EM A NUMBER" 2 
> 1 CHOOSE 
REPEAT 4 c «c 


■ :■ 


CASE c 1 


THEN 


WHILE 


Checks if the narrie list 
(NAMES) exists, if not, 
creates an empty one. 

While cancel is not pressed, 
creates a choose box that 
lists the database options. 
When OK is pressed, the 
second item in the list pair 
is returned to the stack. 

Stores the returned value in 

c. 

Case 1 (ADD name), while 
cancel is not pressed, do the 
following: 
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Program: 

"ADD H NAME 11 


C "NflMEs" "ENTER NAME" 2 
*C "PHONEs" "ENTER A 
PHONE NUMBER" 2 > } 




> INFORM 


REPEAT 


DUP 


NOVflL > HEAD POS 


IF € 

THEN 

DROP 

"Complete both fields 
before pressing OK" 
MSGBOX 
ELSE 1 

■+LIST NAMES + SORT 
'NAMES* STO 
END 
END 
END 


L. £ 


THEN 

IF *L > NAMES SAME 
THEN 

"YOU MUST HDD A 
NAME FIRST" 
MSGBOX 


Comments: 

Creates an input form that 
gets the name and phone 
number. The two fields 
accept only strings (object 
type 2). 


Checks if either field in the 
new entry is blank. 


If either one is, displays a 



If neither are, adds the list 
to NAMES, sorts it, and 
stores it back in NAMES. 
Ends the IF structure, the 
WHILE loop, and the 
CASE statement. 

Case 2 (View a Number). 

Checks if NAMES is an 
empty list. 

If it is, displays a message. 
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Program: 

Comments: 

Pi QP 

If NAMES isn't empty, 

WHILE 

creates a choose box using 

"VIEW fi NUMBER" 

NAMES 1 CHOOSE 

NAMES as choice items. 

REPEHT 

When OK is pressed, the 

*STR MSGBOX 

second item in the NAMES 
list pairs (the phone 
number) is returned. Makes 
it a string and displays it. 

END 

Ends the WHILE loop, the 

END 

IF structure, and the CASE 

END 

statement. 

END 

Ends the CASE structure. 

& 

marks the end of the local 

END 

variable defining procedure, 

& 

ends the WHILE loop, and 
marks the end the program. 

(ENTERl m PHONES fsTol 

Stores the program in 

PHONES . 


You can delete names and numbers by editing the NAMES variable. 
To improve upon this program, create a delete name routine. 


Beeping to Get Attention 


To enter BEEP in a program: 


1. Enter a number that specifies the tone frequency in hertz. 

2. Enter a number that specifies the tone duration in seconds. 


3. Enter the BEEP command ( [PRG] [NXT ) llBlilP menu), 
•& ... frequency duration BEEP ... 


BEEP takes two arguments from the stack: the tone frequency from 
level 2 and the tone duration from level 1. 


Example: The following edited version of TPROMPT sounds a 
440-hertz, one-half-second tone at the prompt for data input. 
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Program: 


Comments: 

V* 

“ENTER a? b IN C 

JRDER n " 


448 „5 BEEP 

PROMPT 

TORSfl 


Sounds a tone just before the 
prompt for data input. 


Stopping a Program for Keystroke Input 

A program can stop for keystroke input—it can wait for the user to 
press a key. You can do this with the WAIT and KEY commands. 

Using WAIT for Keystroke Input 

The WAIT command normally suspends execution for a specified 
number of seconds. However, you can specify that it wait indefinitely 
until a key is pressed. 

To enter WAIT in a program: 

■ To stop without changing the display, enter 0 and the WAIT 
command (PRG IN menu). 

■ To stop and display the current menu, enter — 1 and the WAIT 
command (PRG IN menu). 

WAIT takes the 0 or —1 from level 1, then suspends execution until a 
valid keystroke is executed. 

For an argument of —1, WAIT displays the currently specified menu. 
This lets you build and display a menu of user choices while the 
program is paused. (A menu built with MENU or TMENU is not 
normally displayed until the program ends or is halted.) 

When execution resumes, the three-digit key location number of 
the pressed key is left on the stack. This number indicates the row, 
column, and shift level of the key. 
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To respond to WAIT while running a program: 

■ Press any valid keystroke. (A prefix key such as f*i) or (a) by itself 
is not a valid keystroke.) 


Using KEY for Keystroke Input 

You can use KEY inside an indefinite loop to “pause” execution until 
any key— or a certain key—is pressed. 


To enter a KEY loop in a program: 

1. Enter the loop structure. 

2. In the test-clause sequence, enter the KEY command (PRG IN 
menu) plus any necessary test commands. 

3. In the loop-clause, enter no commands to give the appearance of a 
“paused” condition. 

KEY returns 0 to level 1 when the loop begins. It continues to return 
0 until a key is pressed—then it returns 1 to level 1 and the two-digit 
row-column number of the pressed key to level 2. For example. 
[ENTER] returns 51, and GED returns 71. 

The test-clause should normally cause the loop to repeat until a key is 
pressed. If a key is pressed, you can use comparison tests to check the 
value of the key number. (See “Using Indefinite Loop Structures" on 
page 1-36 and “Using Comparison Functions” on page 1-17.) 


To respond to a KEY loop while running a program: 


■ Press any key. (A prefix key such as (*t 1 or (a) is a valid key.) 

Example: The following program segment returns 1 to level 1 if £+) 
is pressed, or 0 to level 1 if any other key is pressed: 




DO UNTIL KEY END 95 SfiME 


* * m 
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Output 

You can determine how a program presents its output. You can make 
the output more recognizable using the techniques described in this 
section. 

Data Output Commands 


Key | 

Command 

Description 


1 ■ . . iiWI ‘ ■ ■' l i'. l ■■«■ 1 . .* 

rnmmm: 


r p r i i ■ ■■ ■ i nan . . BL-kkkaaBBBBar----- 

mm wm 

.. 1 1 i 

PVIEW 

Displays PICT starting at the given 
coordinates. 

. ■ ■ iritl L ' ■ -HfW- A A" 

■ ■ * a a ■ 1 ikkk ( ■ i p - -r ■ - --saai 

■ ■ ■ ■ ■ ■ ■ ■ a r a .||Lii k i . |>K-> - - «■ “*- a = a a 

.*■ ■" ■ ■ ■ fiCfl lj 1 -9 

EL iV t ! .-.v.--.- ■ 

TEXT 

Displays the stack display. 

■ i. ■ ■ i k |. | k ; p a p p a ■ a - --a-a.-*.>i a a a a a- 

rill 1 l. | |. | | 

CLLCD 

Blanks the stack display. 

.»4* —n.- 

■ | aer "IP ‘"“(I 11 -■ 'I '■ 1 « • ■ 

--v.-L*. .■ .JL-’.’.W.’- l-w.v.v.v 

BBBJBB---rp r-laaaaaaaaaa?rjj - r 

' DISP 

Displays an object in the specified line. 

r r. 

.-- -.. Iin ! 

■■■■HlkllMHMMfiii ■ . .. . ! 

FREEZE 

“Freezes" a specified area of the display 
until a key press. 

: t 1-3: 1^1 

iaa-n-i-i-i'!ij|jj u j i i j j ii ■ ii i ii ; if ib 

MSGBOX 

Creates a user-defined message box. 

i . „ , . ......I I . i_r r - . - r - r -J - - r 

BEEP 

Sounds a beep at a specified frequency 
(in hertz, level 2) and duration (in 
seconds, level 1). i 


Labeling Output with Tags 

To label a result with a tag: 

1. Put the output object on the stack. 

2. Enter a tag—a string, a quoted name, or a number. 

3. Enter the —ATAG command (PRG TYPE menu). 

« ... object tag *TRG ... & 

^TAG takes two arguments—-an object and a tag—from the stack 
and returns a tagged object. 

Example; The following program TTAG is identical to TIN PUT . 

except that it returns the result as RREfis value. 
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Comments: 


Program: 

•:K 

"Key in a? b" 

C M sas»sbs" Cl 0> V > 
INPUT OBJ* 

TOP SB 


Enters the tag (a string). 

Uses the program result and 
string to create the tagged object. 

Stores the program in TTAG. 


ii CiDCiIi ei 

n Ken 

-H-TflG 


(ENTER] Q TTAG fST6] 


Execute TTAG to calculate the area of a torus of inner radius a = 1.5 
and outer radius b — 1.85. The answer is returned as a tagged object. 



(VARl 

1.5 © 1.85 

(ENTER] 


1: flREfls 11.5721111603 


TTHG TINPU PH TPF;D T0F;SV TDR'ift 


Labeling and Displaying Output as Strings 

To label and display a result as a string: 

1. Put the output object on the stack. 

2. Enter the -*STR command (PRG TYPE menu). 

3. Enter a string to label the object (with " " delimiters). 

4. Enter the SWAP + commands to swap and concatenate the strings. 

5. Enter a number specifying the line to display the string on. 

6. Enter the DISP command (PRG OUT menu). 

•£ ... object *STR label SWfiP + line DISP ... :$• 

DISP displays a string without its " " delimiters. 

Example: The following program TSTHING is identical to TINP VT , 
except that it converts the program result to a string and appends a 
labeling string to it. 
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Comments: 


Program: 


"Key in a-■ b 

r i i 5 ii «« ii I... ii II 
h ii 1 ii \ m l ii 

INPUT 0BJ-+ 


II 






H 


Fl r e a 


H 




CLLCD 1 DISP 1 FREEZE 


Converts the result to a string. 
Enters the labeling string. 

Swaps and adds the two strings. 
Displays the resultant string, 
without its delimiters, in line 1 of 
the display. 


fENTER 1 CD TSTRING fSTOl Stores the program in TSTRING . 


Execute TSTRING to calculate the area of the torus with a m. 1.5 and 
b = 1.85. The labeled answer appears in the status area. 


f^llf CLEAR) 




1.5® 1.85 

(Inter) 


Area = 11.5721111603 

4 = 

3s 

2 ■ 
is 


T: 

>TF;I 

TThG 

TINPU 

VSPH 

TPF; 

gi 

TDFil 



Pausing to Display Output 

To pause to display a result: 

1. Enter commands to set up the display. 

2. Enter the number of seconds you want to pause. 

3. Enter the WAIT command (PRG IN menu). 

WATT suspends execution for the number of seconds in level 1. 

You can use WAIT with DISP to display messages during program 
execution—for example, to display intermediate program results. 
(WAIT interprets arguments 0 and —1 differently—see " Using WAIT 
for Keystroke Input/’ on page 1-72.) 
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Using MSGBOX to Display Output 


To set up a message box: 


1. Enter a message string. 

2. Execute the MSGBOX command 


Example: 


Execute MSGBOX ( fPRGl (NXT) 
The following message appears: 


Enter a string “HELLO? WORLD" [ENTER) . 

I ■ hi I J J ! a ilaa ■ ■ h h ■ ■ ■ ■ . jI ■ ■ ■■ ■ i 
t —. 8 ifli j i B ! I ! » 

-I 

-I - - I . I - ■ J I • 1 1 

... .a .a - -qpqb- - L . 8 i ■ ■ f;i 8 i § 


I ? -I 

' ■ r " I 

I 




Wv.w 


)• 


t HOME > 



HELLO, WORLD | 

"HELLO, UORLD" 



You must acknowledge a message box by pressing 
[CANCEL 1. 



or 


Using Menus with Programs 

You can use menus with programs for different purposes: 

■ Menu-based input. A program can set up a menu to get input 
during a halt in a program- then resume executing the same 
program. 

■ Menu-based application. A program can set up a menu and finish 

executing, leaving the menu to start executing other related 
programs. 

To set up a built-in or library menu: 

1. Enter the menu number. 

2. Enter the MENU command (MODES MENU menu). 
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To set up a custom menu: 

1. Enter a list (with C delimiters) or the name of a list defining the 
menu actions. If a list of two element lists is given, the first element 
appears in the menu, but it is the second element that is returned 
to the stack when the menu key is pressed. 

2. Activate the menu: 

■ To save the menu as the CST menu, enter the MENU command 
(MODES MENU menu). 

■ To make the menu temporary, enter the TMENU command 

(MODES MENU menu). 

The menu isn’t displayed until program execution halts. 

Menu numbers for built-in menus are listed in chapter 3, under the 
MENU command. Library menus also have numbers—the library 
number serves as the menu number. So you can activate applications 
menus (such as the SOLVE and PLOT menus) and other menus (such 
as the VAR and CST menus) in programs. The menus behave just as 
they do during normal keyboard operations. 

You create a custom menu to cause the behavior you need in your 
program—see the topics that follow. You can save the menu as the 
CST menu, so the user can get it again by pressing [CST ) . Or you can 
make it temporary —it remains active (even after execution stops), but 
only until a new menu is selected—and it doesn’t affect the contents of 
variable CST. 

To specify a particular page of a menu, enter the number as m.pp, 
where m is the menu number and pp is the page number (such as 
94.02 for page 2 of the TIME menu). If page pp doesn’t exist, page 1 
is displayed (94 gives page 1 of the TIME menu). 

Example: Enter 69 MENU to get page 1 of the MODES M1SC menu. 
Enter 69- 92 MENU to get page 2 of the MODES MISC menu. 

To restore the previous menu: 

■ Execute 0 MENU. 

To recall the menu number for the current menu: 

■ Execute the RCLMENU command (MODES MENU menu). 
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Using Menus for Input 


To display a menu for input in a program: 

1. Set up the menu—see the previous section. 

2. Enter a command sequence that halts execution (such as DISP, 

PROMPT, or HALT). 

The program remains halted until it s resumed by a CONT command, 
such as by pressing f^n fCONT) . If you create a custom menu for input, 
you can include a CONT command to automatically resume the 
program when you press the menu key. 

Example: The following program activates page 1 of the MODES 
ANGL menu and prompts you to set the angle mode. After you press 
the menu key, you have to press f^ircoNp to resume execution. 



65 MENU 



Angle Mode" 


PROMPT 



Example: The PIE program on page 2-49 assigns the CONT 
command to one key in a temporary menu. 

Example: The MNX program on page 2-22 sets up a temporary 
menu that includes a program containing CONT to resume execution 
automatically. 


Using Menus to Run Programs 

You can use a custom menu to run other programs. That menu 
can serve as the main interface for an application (a collection of 
programs). 

To create a menu-based application: 

1. Create a custom menu list for the application that specifies 
programs as menu objects. 

2. Optional: Create a main program that sets up the application 
menu—either as the CST menu or as a temporary menu. 

Example: The following program, WGT, calculates the mass of an 
object in either English or SI units given the weight. WGT displays 
a temporary custom menu, from which you run the appropriate 
program. Each program prompts you to enter the weight in the 
desired unit system, then calculates the mass. The menu remains 
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active until you select a new menu, so you can do as many calculations 
as you want. 

Enter the following list and store it in LST: 



"ENGL” ■*: "ENTER m in POUNDS" PROMPT 32 


H e 


SI" f "ENTER m in MEN TONS" PROMPT 9.. S i :*■ 



CD LST fsTol 

Program: Comments: 

■£ LST TMENU x- Displays the custom menu stored 

in LST. 

[ENTER] CD WGT (STO ] Stores the program in WGT. 


Use WGT to calculate the mass of an object of weight 12.5 N. The 
program sets up the menu, then completes execution. 



Select the SI unit system, which starts the program in the menu list. 



Example: The following program, EIZ. constructs a custom menu 
to emulate the HP Solve application for a capacitive electrical circuit. 
The program uses the equation E = IZ f where E is the voltage, I is 
the current, and Z is the impedance. 

Because the voltage, current, and impedance are complex numbers, 
you can’t use the HP Solve application to find solutions. The custom 
menu in EIZ assigns a direct solution to the left-shifted menu key for 
each variable, and assigns store and recall functions to the unshifted 
and right-shifted keys—the actions are analogous to the HP Solve 
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application. The custom menu is automatically stored in CST, 
replacing the previous custom menu—you can press fcsf ) to restore 

the menu. 


Program: 





11 ET 

I~ 


n / 


4_m_ 


1 E 1 STO s- 


I Z * DUP 1 E 1 STO 


11 E 3 


n 


SWAP + CLLCD 


1 DISP 1 FREEZE » 


* E » 


"1 


1! 


& 
n * 


1 I 1 STO * 


E Z / DUP 'I' STO 


"is 


M 


B N fl P + ij L L U D 


1 DISP 1 FREEZE » 


« I 


>: “? si _r 


I I 

Ihh 


STO » 


f E I / DUP 


I 1 


STO 


H "*? u II 


SNAP + CLLCD 


1 DISP 1 FREEZE $ 


MENI. 


Comments: 

Sets Degrees mode. Sets flags 
— 15 and —16 to display complex 
numbers in polar form. Sets the 
display mode to 2 Fix. 

Starts the custom menu list. 

Builds menu key 1 for E. 
Unshifted action: stores the 
object in E. Left-shift action: 
calculates I x Z, stores it in E, 
and displays it with a label. 
Right-shift action: recalls the 
object in E. 

Builds menu key 2. 


Builds menu key 3. 


Ends the list. 

Displays the custom menu. 


fENTERl Q EIZ fSTCT) 


Stores the program in EIZ. 


For a 10-volt power supply at phase angle 0°, you measure a current of 
0.37-amp at phase angle 68°. Find the impedance of the circuit using 


EIZ . 


f^hl(CLEARl fVARl . Wl 
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Key in the voltage value. 

® (H) 10 13(3 o 


(10<£0« 








h 

Store the voltage value. Then key in and store the current value 
Solve for the impedance. 



_ .37 

■J 1 1 * 1 *^fcjfc, pprr-r -r ■ ■ r ■■■■■■■. 

f m rp-p r-rraai >V771 ■■■■■■■ I.JJ. 

« ■ i--p p mmMr i k r r i j 

II ■ ... 

I 11 

L ■ J i - r - i i i p i p i . 1.1 1.1.«. i. ■ p 1.1. _ _ _ _ _ _ _ _ _ _ _ _ 

. . 



68 



Recall the current and double it. Then find the voltage. 

© in 

2 © 


S) 



Press (4-TH MOPES ! IlHlflf 1811111 and (NXTl ■■Pli 8BS?ffi» 

*>_~ - _ M [f Jf . 


Ilfiil to restore Standard and Rectangular modes. 


Turning Off the HP 48 from a Program 

To turn off the calculator in a program: 

■ Execute the OFF command (PRG RUN menu). 

The OFF command turns off the HP 48. If a program executes OFF, 
the program resumes when the calculator is next turned on. 
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Programming Examples 



The programs in this chapter demonstrate basic programming 
concepts. These programs are intended to improve your programming 
skillsj and to provide supplementary functions for your calculator. 


At the end of each program, the program’s checksum and size in bytes 
are listed to help make sure you typed the program in correctly. (The 
checksum is a binary integer that uniquely identifies the program 
based on its contents). To make sure you’ve keyed the program in 
correctly, store it in its name, put the name in level 1, then execute 


the BYTES command ( f<h1 (MEMORY ] This returns the 

program’s checksum to level 2, and its size in bytes to level 1. (If 
you execute BYTES with the program object in level 1, you’ll get a 
different byte count.) 


The programs in this chapter are also included in the online 
information of the Program Development Link software for developing 
HP 48 programs on computers. This software lets you load these 

programs from the online information into your HP 48 through its 
serial port. 


The examples in this chapter assume the HP 48 is in its initial, 
default condition—they assume you haven’t changed any of the 
HP 48 operating modes. (To reset the calculator to this condition, see 
"Memory Reset” in chapter 5 of the HP 48 User’s Guide j) 

Each program listing in this chapter gives the following information: 

■ A brief description of the program. 

■ A syntax diagram (where needed) showing the program s required 
inputs and resulting outputs. 

■ Discussion of special programming techniques in the program. 

■ Any other programs needed. 

■ The program listing. 

■ The program’s checksum and byte size. 
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Fibonacci Numbers 

This section includes three programs that calculate Fibonacci 

numbers: 

■ FIBI is a user-defined function that is defined recursively (that is, 
its defining procedure contains its own name). FIB1 is short. 

■ FIB2 is a user-defined function with a definite loop. It ? s longer and 
more complicated than FIBI , but faster. 

■ FIBT calls both FIBI and FIB2 and calculates the execution time 
of each subprogram. 

FIBI and FIB2 demonstrate an approach to calculating the nth 

Fibonacci number F n , where: 

Fo — 0, F\ = 1, F n ~ F n -i~\- F n -2 

FIBI (Fibonacci Numbers, Recursive Version) 



Level 1 -► 

Level 1 


n — y 

F n 


Techniques used in FIBI 

■ IFTE (if-then-else function). The defining procedure for FIBI 
contains the conditional function IFTE, which can take its 
argument either from the stack or in algebraic syntax. 

■ Recursion. The defining procedure for FIBI is written in terms of 
FIBI , just as F n is defined in terms of F n _! and F n _ 2 . 
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FIB1 program listing 

Program: 

•s 

-•+ n 

1 IFTE<n^i? 
n? 

FIB1 n- 1 > +FIB1 < n-2 

■ ■ 

■ m- 
m m 

(ENTER) Q FIB1 fSTOl 


Comments: 

Defines local variable n. 

The defining procedure, an 
algebraic expression. If n < 1 

else F n —F n _ 1 +F n _2* 

Stores the program in FIB1 . 


Checksum: 

Bytes: 


# 41467d (press f 1 


iiftfcfc? (MEMORY] 



113.5 


Example: Calculate F q. Calculate Fio using algebraic syntax. 


First calculate F6- 


(VAR) 




Next, calculate Fio using algebraic syntax. 


□ ns ao 10 f eval i 


2 > 8 

1: 55 


FIEU NJN FPhF; IDPhF; 


FIB2 (Fibonacci Numbers, Loop Version) 



Level 1 

- 

Level 1 



n 

- 

F n 



Techniques used in FIB2 

■ IF ... THEN ... ELSE ... END. FIB2 uses the program-structure 
form of the conditional. ( FIB1 uses IFTE.) 
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■ START ... NEXT (definite loop). To calculate F n , FIB 2 starts 
with Fo and Fi and repeats a loop to calculate successive values of 

F 
1 1 • 


FIB2 program listing 

Program: Comments: 

•*: 

+ n Creates a local variable structure. 


IF n U 
THEN n 
ELSE 
0 1 
2 n 
START 
DIJ P 
ROT 

4" 


NEXT 

SWAP DROP 


END 



If n < 1, 
then F n = n\ 
otherwise ... 

Puts Fo and Fi on the stack. 

From 2 to n does the following 
loop: 

Copies the latest F (initially Fi). 
Gets the previous F (initially Fo). 
Calculates the next F (initially 

F 2 )> 

Repeats the loop. 

Drops F„_j. 

Ends the ELSE clause. 

Ends the defining procedure. 


[ENTER"! q YIB2 fSTO 1 


Stores the program in FIB2. 


Checksum: 

Bytes: 


# 51820d (press Q3 
89 



(MEMORY] 



Example: Calculate Fq and Fio 

Calculate Fq. 


(var) 

6 HB 


i 

, M . 

,'irl 


n 8 


FIE-S mi NJN PPHF; IDPiiF; 
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Calculate Fiq, 



FIBT (Comparing Program-Execution Time) 

FIBl calculates intermediate values more than once, while FIB2 
calculates each intermediate Fj only once. Consequently, FIB2 is 
faster. The difference in speed increases with the size of n because the 
time required for FIBl grows exponentially with n, while the time 
required for FIB2 grows only linearly with n . 

FIBT executes the TICKS command to record the execution time of 
FIBl and FIB2 for a given value of n. 


Level 1 

■* Level 3 

Level 2 

Level 1 

n 

■+ n 

FIBl TIME: z 

FIB2 TIME: z 


Techniques used in FIBT 

■ Structured progratnming. FIBT calls both FIBl and FIB2. 

■ Programmatic use of calculator clock. FIBT executes the TICKS 
command to record the start, and finish of each subprogram. 

■ Labeling output. FIBT tags each execution time with a descriptive 
message. 

Required Programs 

■ FIBl (page 2-2) calculates F n using recursion. 

■ FIB2 (page 2-3) calculates F n using looping. 
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FIBT program listing 


Program: 


Comments: 




DUP TICKS SNAP FIB1 

Copies n , then executes FIB1 , 

SWAP TICKS SWAP 

recording the start and stop time. 

- B*R 8192 

Calculates the elapsed time, 
converts it to a real number, and 
converts that number to seconds. 
Leaves the answer returned by 
FIB1 in level 2. 

"FIB1 TIME" -h-TAG 

Tags the execution time. 

ROT TICKS SWAP FIB2 

Executes FIBS ^ recording the 

TICKS 

start and stop time. 

SWAP DROP SWAP 

Drops the answer returned by 

- B*R 8192 •••'' 

FIB2 ( FIB1 returned the same 
answer). Calculates the elapsed 
time for FIBS and converts to 
seconds. 

"FIB2 TIME" +TAG 

w 

Tags the execution time. 

B ■■ 

■ 4 

[ENTER)n FIBT (STO) 

Stores the program in FIBT . 


Checksum: # 22248d 
Bytes: 135 


Example: Calculate F 13 and compare the execution time for the two 
methods. 

Select the VAR menu and do the calculation. 


(VAR) 


13 lllSf 


i HOME > 


3 

2 

1 


161 TIME: 22 


FIBS TI 


£33 

3896... 


E= 


. 08£2753906£5 


FIE ; T 

FIE2 

FIE1 

NJN 

PPfiF; 



11I: 


F 13 is 233. FIB2 takes fewer seconds to execute than FIB1 (far fewer 
if n is large). (The times required for the calculations depend on the 
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contents of memory and other factors, so you may not get the exact 
times shown above.) 


Displaying a Binary Integer 

This section contains three programs: 

■ PAD is a utility program that converts an object to a string for 
right-justified display. 

■ PRESERVE is a utility program for use in programs that change 
the calculator’s status (angle mode, binary base, and so on). 

■ BDISP displays a binary integer in HEX, DEC, OCT. and BIN 
bases. It calls PAD to show the displayed numbers right-justified, 
and it calls PRESERVE to preserve the binary base. 

PAD (Pad with Leading Spaces) 

PAD converts an object to a string, and if the string contains fewer 
than 22 characters, adds spaces to the beginning of the string till the 
string reaches 22 characters. 

When a short string is displayed with DISP, it appears left-justified : 
its first character appears at the left end of the display. By adding 
spaces to the beginning of a short string, PAD moves the string to 
the right. When the string (including leading spaces) reaches 22 
characters, it appears right-justifled: its last character appears at the 
right end of the display. PAD has no effect on longer strings. 


Level 1 

. Level 1 

object 

■+ " object " 


Techniques used in PAD 

■ WHILE ... REPEAT ... END (indefinite loop). The WHILE 

clause contains a test that executes the REPEAT clause and tests 
again (if true) or skips the REPEAT clause and exits (if false). 
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■ String operations. PAD demonstrates how to convert an object 
to string form, count the number of characters, and combine two 
strings. 


PAD program listing 

Program: 


NHILE 





PCppflT 

I ■* 1 Li. i x 


H 


II 


END 




Comments: 

Makes sure the object is in string 
form. (Strings are unaffected by 
this command.) 

Repeats if the string contains 
fewer than 22 characters. 

Loop-clause adds a leading space. 
Ends loop. 


[ENTER) CD PAD fSTQl 


Stores the program in PAD. 


Checksum: 

Bytes: 


# 38912d 
61.5 


PAD is demonstrated in the program BDISP . 

PRESERVE (Save and Restore Previous Status) 

PRESERVE stores the current calculator (flag) status, executes a 

program from the stack, and restores the previous status. 


Level 1 s-* Level 1 

< program > —► result of program 

'program name 1 —► result of program 


2-8 Programming Examples 









Techniques used in PRESERVE 

■ Preserving calculator flag status. PRESERVE uses RCLF (recall 
flags ) to record the current status of the calculator in a binary 
integer, and STOP (store flags ) to restore the status from that 
binary integer. 

■ Local-variable structure. PRESERVE creates a local variable 
structure to briefly remove the binary integer from the stack. Its 
defining procedure simply evaluates the program argument, then 
puts the binary integer back on the stack and executes STOF. 

■ Error trapping. PRESERVE uses IFERR to trap faulty program 
execution on the stack and to restore flags. DOERR shows the error 
if one occurs. 


PRESERVE program listing 

Program: 

■$: 

R C L F 


IFERR 

EVflL 

THEN 

f STOF ERRN DOERR 
END 

f STOF 


(ENTER 1 CD PRESERVE fSTOl 


Comments: 

Recalls the list of two 64-bit 
binary integers representing the 
status of the 64 system flags and 
64 user flags. 

Stores the list in local variable /. 
Begins the defining procedure. 
Starts the error trap. 

Executes the program placed on 
the stack as the level 1 argument. 
If the program caused an error, 
restores flags, shows the error, 
and aborts execution. 

Ends the error routine. 

Puts the list back on the stack, 
then restores the status of all 
flags. 

Ends the defining procedure. 
Stores the program in 

PRESERVE . 
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Checksum: # 7284d 
Bytes: 71 


PRESERVE is demonstrated in the program BDISP . 

BDISP (Binary Display) 

BDISP displays a real or binary number in HEX. DEC, OCT, and 
BIN bases. 


Level 1 

- 

Level 1 

# n 

- 

# n 

n 


n i 


Techniques used in BDISP 

■ IF ERR ... THEN ... END (error trap). To accommodate 
real-number arguments, BDISP includes the command R—*B 
(real-io-binary). However, this command causes an error if the 
argument is already a binary integer. To maintain execution if 
an error occurs, the R—»B command is placed inside an IF ERR 
clause. No action is required when an error occurs (since a binary 
number is an acceptable argument), so the THEN clause contains no 
commands. 

■ Enabling LASTARG. In case an error occurs, the LASTARG 
recovery feature must be enabled to return the argument (the 
binary number) to the stack. BDISP clears flag —55 to enable this. 

■ FOR ... NEXT loop (definite loop with counter). BDISP executes 
a loop from 1 to 4, each time displaying n (the number) in a 
different base on a different line. The loop counter (named j in this 
program) is a local variable created by the FOR ... NEXT program 
structure (rather than by a command), and automatically 
incremented by NEXT. 

■ Unnamed programs as arguments. A program defined only by its 
€ and :*■ delimiters (not stored in a variable) is not automatically 
evaluated, but is placed on the stack and can be used as an 
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argument for a subroutine. BDISP demonstrates two uses for 
unnamed program arguments: 

n BDISP contains a main program argument and a call to 

PRESERVE. This program argument goes on the stack and is 
executed by PRESERVE . 

□ BDISP also contains four program arguments that “customize” 
the action of the loop. Each of these contains a command to 
change the binary base, and each iteration of the loop evaluates 
one of these arguments. 

When BDISP creates a local variable for n, the defining procedure 
is an unnamed program. However, since this program is a defining 
procedure for a local variable structure, it is automatically executed. 

Required Programs 

m PAD (page 2-1) expands a string to 22 characters so that DISP 
shows it right-justified. 

■ PRESERVE (page 2-8) stores the current status, executes the main 
nested program, and restores the status. 


BDISP program listing 

Program: 


i LI P 


E^T ET 
■_ \ ■■ 1 


CF 


I F ERR 

R 

THEN 

END 


n 




CLLCD 


BIN 

OCT 


■¥ 


D E C S' 
HEN * 


Comments: 

Begins the main nested program. 
Makes a copy of n. 

Clears flag —55 to enable 

LASTARG. 

Begins error trap. 

Converts n to a binary integer. 

If an error occurs, do nothing (no 
commands in the THEN clause). 

Creates a local variable n and 
begins the defining program. 

Clears the display. 

Nested program for BIN. 

Nested program for OCT. 

Nested program for DEC. 

Nested program for HEX, 


Programming Examples 2-11 







(ENTER) CD BDISP fSTOl 

Checksum: # 18055d 
Bytes: 191 


Comments: 

Sets the counter limits. 

Starts the loop with counter j . 

Executes one of the nested base 
programs (initially for HEX). 
Makes a string showing n in the 
current base. 

Pads the string to 22 characters. 
Displays the string in the j th line. 
Increments j and repeats the 
loop. 

- Ends the defining program. 

Freezes the status and stack 
areas. 

Ends the main nested program. 

Stores the current flag status, 
executes the main nested 
program, and restores the status. 

Stores the program in BDISP . 


Example: Switch to DEC base, display #100 in all bases, and check 
that BDISP restored the base to DEC. 

Clear the stack and select the MTII BASE menu. Make sure the 

current, base is DEC and enter # 100. 



«■ 
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Execute BDISP. 



# 64h 
# 100d 
tt 144o 
# 1100100b 


E* ['ISP 





Return to the normal stack display and check the current base. 


fCANCEL] 

1MTH11& 



Although the main nested programdeft the calculator in BIN base, 
PRESERVE restored DEC base. To check that BDISP also works for 
real numbers, try 144. 


(VARl 


144 il 


iiiiniii 


# 90h 

# 144d 

# 

# 10010000b 


EC'ISPl FIE:3 |PF;E:"E 


■ana 


FIST 



Press (CANCEL) to return to the stack display. 
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Median of Statistics Data 

This section contains two programs: 

■ %TILE returns the value of a specified percentile of a list. 

■ MEDIAN uses %TIIE to calculate the median of the current 
statistics data. 

(%TIIE and MEDIAN are included in the TEACH function’s 
EXAMPLES directory. See the entry for TEACH in chapter 3.) 


UTILE (Percentile of a List) 


%TILE sorts a list, then returns the value of a specified percentile of 
the list. For example, typing C list”} 5@ and pressing 11B1||1 returns 
the median (50th percentile) of the list. 


Level 2 

Level 1 

- Level 1 

{ list } 

n 

-+ n th percentile of sorted list 


Techniques used in %TILE 

■ FLOOR and CEIL. For an integer, FLOOR and CEIL both return 
that integer; for a noninteger, FLOOR and CEIL return successive 
integers that bracket the noninteger. 

■ SORT. The SORT command sorts the list elements into ascending 

order. 
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%TILE program listing 


Program: 

SWAP SORT 

DUP SIZE 
1 + ROT 100 / * 

p 

■ft 

DUP 

P FLOOR GET 


SWAP 

P CEIL GET 
+ 2 ■■■■' 


(ENTER) Q %TILE fSTOl 

Checksum: # 42718d 
Bytes: 99 


Comments: 


Brings the list to level 1 and sorts 
it. 

Copies the list, then finds its size. 

Calculates the position of the 
specified percentile. 

Stores the center position in local 
variable p. 

Begins the defining procedure. 
Makes a copy of the list. 

Gets the number at or below the 
center position. 

Moves the list to level 1. 

Gets the number at or above the 
center position. 

Calculates the average of the two 
numbers. 

Ends the defining procedure. 
Stores the program in %TILE . 


Example: Calculate the median of the list { 8 3 1 5 2 }. 


Q(T>) 8 3 1 5 2 (ENTER) 

— ■ — — g ■ ■ ■ ■ ■ H I ■■ilk a i- Ik i i .. 

(var] 50 IlSiliS 

iJaa.fca-aa ■ ■ Vi a # J -i . . 


1 * 3 


T1L E 

BP ISP 

F(E : 3 

PF;E: 

:e 

PHD 

FIBT 
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MEDIAN (Median of Statistics Data) 

MEDIAN returns a vector containing the medians of the columns of 
the statistics data. Note that for a sorted list with an odd number of 
elements, the median is the value of the center element; for a list with 
an even number of elements, the median is the average value of the 
elements just above and below the center. 


Level 1 



Level 1 


[x 2 ... x m ] 


Techniques used in MEDIAN 

■ Arrays, lists, and stack elements. MEDIAN extracts a column of 
data from MDAT in vector form. To convert the vector to a list, 
MEDIAN puts the vector elements on the stack and combines them 
into a list. From this list the median is calculated using %TILE . 

The median for the mth column is calculated first, and the median 
for the first column is calculated last. As each median is calculated, 
ROLLD is used to move it to the top of the stack. 

After all medians are calculated and positioned on the stack, they’re 
combined into a vector. 

■ FOR ,.. NEXT (definite loop with counter). MEDIAN uses a loop 
to calculate the median of each column. Because the medians are 
calculated in reverse order (last column first), the counter is used to 
reverse the order of the medians. 

Required Program 

■ %TILE (page ) sorts a list and returns the value of a specified 
percentile. 
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MEDIAN program listing 


Program; 




RCLZ 


DUP SIZE 


OUt DROP 


t s n m 


I X 


SDfiT’ TRN 


1 r«*i 

FOR .i 


OBJ# DROP 


n 4-LIST 

58 STILE 


i ROLLD 


NEXT 


Comments: 

Puts a copy of the current 
statistics matrix EDAT on the 
stack. 

Puts the list { n m } on the 
stack, where n is the number of 
rows in EDAT and m is the 
number of columns. 

Puts n and m on the stack, and 
drops the list size. 

Creates local variables for s, n, 
and m. 

Begins the defining procedure. 

Recalls and transposes EDAT, 
Now n is the number of columns 
in EDAT and m is the number of 
rows. (To key in the 2 character, 
press (r*)frT then delete the 
parentheses.) 

Specifies the first and last rows. 
For each row, does the following: 

Extracts the last row in EDAT, 
Initially this is the mth row, 
which corresponds to the mth 
column in the original EDAT, 

(To key in the E— command, 



Puts the row elements on the 
stack. Drops the index list { n }. 
Makes an ra-element list. 

Sorts the list and calculates its 
median. 

Moves the median to the proper 
stack level. 

Increments j and repeats the 
loop. 
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Program: 



* FIRRY 



♦V 

» 

[ ENTER 1 Q MEDIAN fSTO~l 


Comments: 

Combines all the medians into an 
m-element vector. 

Restores EDAT to its previous 
value. 

Ends the defining procedure. 
Stores the program in MEDIAN. 


Checksum: # 57504d 
Bytes: 140 


Example: Calculate the median of the following data. 

-18 12- 
4 7 

3 2 

11 1 
31 48 
.20 17. 

There are two columns of data, so MEDIAN will return a two-element 
vector. 


Enter the matrix. 


(r»)f MATRIX) 


18 fENTER) 12 (ENTER) (V) 

4 (ENTER) 7 (ENTER) 

3 (ENTER) 2 (ENTER) 

11 fENTER) 1 fENTER) 

31 (ENTER) 48 (ENTER) 

20 (ENTER) 17 [ENTER) 
(ENTER) 


1: [[ 18 12 ] 


[ 4 ? ] 
[ 32 ] 

[ 11 1 ] 


','ECTF; 

MtiTF; 

LIST 

HYP 

FlEtHL 

fflSE 


Store the matrix in EDAT, and calculate the median. 


f<i-T) (STAT) § 111111 


! ■! ‘ ■ X ■;: EI-I-I-IM-X■-vM 

■ 1 ■ ■ ■ 1 I ■ ■ . ■ ■ ."1 . s i l r ' . • ' • * WPP* .. 

■i . . . . ■ I. i r t ■ t i|,l ■! ini i ■ i i i j - r f,i r - m ■ ■■ n ■ — — — — — 

a , . 1 .. . « . ■ at _ . . I a. I 6 J i 1 . d ■ ■ - (i ■ « ■ ■ ranj ■ ■ ri . f- 

.m ■ ■ iM■ i 1 ^ ■ >WI4 ■ ■ ■ -- --------- — ■ 


1: 




ME&frt 


[ 14.5 9.5 ] 

miliHUHJ I 



fVAR) RHIl 

. 
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Expanding and Collecting Completely 

This section contains two programs: 

■ MULTI repeats a program until the program has no effect on its 
argument. 

■ EXCO calls MULTI to completely expand and collect an algebraic. 


MULTI (Multiple Execution) 

Given an object and a program that acts on the object, MULTI 
applies the program to the object repeatedly until the program no 
longer changes the object. 


Level 2 

Level 1 

- Level 1 

object 

< program > 

* o£>ject resu|t 


Techniques used in MULTI 

■ DO ... UNTIL ... END (indefinite loop). The DO clause contains 
the steps to be repeated. The UNTIL clause contains the test that 
repeats both clauses again (if false) or exits (if true). 

■ Programs as arguments. Although programs are commonly named 
and then executed by calling their names, programs can also be put 
on the stack and used as arguments to other programs. 

■ Evaluation of local variables. The program argument to be executed 
repeatedly is stored in a local variable. 

It’s convenient to store an object in a local variable when you domt 
know beforehand how many copies you’ll need. An object stored in 
a local variable is simply put on the stack when the local variable is 
evaluated. MULTI uses the local variable name to put the program 
argument on the stack and then executes EVAL to execute the 
program. 
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MULTI program listing 


Program: 




P EVfiL 


D U P 


ROT 


UNTIL 




(enter! Q MULTI (STOl 

Checksum: # 34314d 
Byt es: 56 


Comments: 

Creates a local variable p that 
contains the program from level 1. 
Begins the defining procedure. 

Begins the DO loop clause. 

Makes a copy of the object, now 
in level 1. 

Applies the program to the 
object, returning its new version. 
Makes a copy of the new object. 

Moves the old version to level 1, 
Begins the DO test clause. 

Tests whether the old version and 
the new version are the same. 
Ends the DO structure. 

Ends the defining procedure. 
Stores the program in MULTI , 


MULTI is demonstrated in the next programming example. 


EXCO (Expand and Collect Completely) 

EXCO repeatedly executes EXPAN on an algebraic until the algebraic 
doesn’t change, then repeatedly executes COLCT until the algebraic 
doesn’t change. In some cases the result will be a number. 

Expressions with many products of sums or with powers can take 
many iterations of EX PAN to expand completely, resulting in a long 
execution time for EXCO. 
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Level 1 


Level 1 


1 algebraic ' -> 1 algebraic ' 

1 algebraic' —* z 


Techniques used in EXCO 

■ Subroutines. EXCO calls the program MULTI twice. It is more 
efficient to create program MULTI and simply call its name twice 
than write each step in MULTI two times. 

Required Programs 

■ MULTI (page 2-19) repeatedly executes the programs that EXCO 
provides as arguments. 

EXCO program listing 

Program: Comments: 

■*: 



EXPAN 


MULT I 
« COLCT » 


MULTI 

y 

ENTER! CD EXCO fSTO 


Puts a program on the stack as 
the level 1 argument for MULTI, 
The program executes the 
EXPAN command. 

Executes EXPAN until the 
algebraic object doesn’t change. 
Puts another program on the 
stack for MULTI. The program 
executes the COLCT command. 
Executes COLCT until the 
algebraic object doesn’t change. 

Stores the program in EXCO, 


Checksum: # 48008d 
Bytes: 65.5 
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Example: Expand and collect completely the expression: 

3 x(4y + z) -h (8a? — 5 z) 2 


Enter the expression. 

Q30X0 

(±DO 4 © Y (±) z ® (T) 

SIO 8 © x 0 5 © z 

®02 

'ENTER| 


1: 1 3*K* C 4*Y+Z)+C8*X-5 

*zr£‘ 

I BSHI 


V ECTR 

MATS 

LIST 

H'i 

t1 

REAL 




Select the VAR menu and start the program. 




■64*r2+12*X*Y-77*X 
*Z+25*Z A 2 1 


E 

!■: ■: d 

MULTI 

-■ 

DAT 

MEDIA 

:-:TlLE 

E-DISP 


Minimum and Maximum Array Elements 

This section contains two programs that find the minimum or 
maximum element of an array: 

■ MNX uses a DO ... UNTIL ... END (indefinite) loop. 

■ MNX2 uses a FOR ... NEXT (definite) loop. 


MNX (Minimum or Maximum Element—Version 1) 

MNX finds the minimum or maximum element of an array on the 
stack. 


Level 1 

- Level 2 

Level 1 

[[ array ]] 

■+ [[ array]] 

i n a x 
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Techniques used in MNX 

■ DO . .. UNTIL ... END (indefinite loop). The DO clause contains 
the sort instructions. The UNTIL clause contains the system-flag 
test that determines whether to repeat the sort instructions. 

■ User and system flags for logic control: 

□ User Q ag 10 defines the sort: When flag 10 is set, MNX finds the 
maximum element; when flag 10 is clear, it finds the minimum 
element. You determine the state of flag 10 at the beginning of 
the program. 

□ System flag —64, the Index Wrap Indicator flag, determines when 
to end the sort. While flag —64 is clear, the sort loop continues. 
When the index invoked by GETI wraps back to the first array 
element, flag —64 is automatically set, and the sort loop ends. 

■ Nested conditional. An IF ... THEN ... END conditional is nested 
in the DO ... UNTIL ... END conditional, and determines the 
following: 


□ Whether to maintain the current minimum or maximum element, 
or make the current element the new minimum or maximum. 

□ The sense of the comparison of elements (either < or >) based on 
the status of flag 10. 


Custom menu. MNX builds a custom menu that lets you choose 
whether to sort for the minimum or maximum element. Key 1, 
labeled sets flag 10. Key 2, labeled ME , clears flag 10. 


■ Logical function. MNX executes XOR (exclusive OR) to test the 
combined state of the relative value of the two elements and the 
status of flag 10. 
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MNX program listing 


Program: 

* 4 



Comments: 


Defines the option menu, i 
sets flag 10 and continues 
execution. 8I3MHH clears flag 

■ ■ ■■■ ■ b an a a a a a a 

and continues execution. 


a BiU_aiiB... 

■ a k i ■ j b ■ iiiii.. 
~ BI « ■ ■ ■ ■ 

WfiV .V.Y.V- 

''I t ! ■ ■■ ■ I II 

i ■ i - ■ ■ - 

! ' IM ■ i i i >i i m ii ■ i 


10 


TMENU 


“Sort for MAX or MIN? 
PROMPT 
1 GET I 
DO 

ROT ROT GETI 


H 


4 ROLL DUP2 


IF 


> 10 FS? KOR 


THEN 

SWAP 

END 


DROP 

UNTIL 
-64 FS? 


END 

SWAP DROP O MENU 


Displays the temporary menu and 
a prompt message. 


Gets the first element of the array. 
Begins the DO loop. 

Puts the index and the array in 
levels 1 and 2, then gets the new 
array element. 

Moves the current minimum or 
maximum array element from 
level 4 to level 1, then copies 
both. 

Tests the combined state of the 
relative value of the two elements 


and the status of flag 10. 

If the new element is either less 
than the current maximum or 
greater than the current 
minimum, swaps the new element 
into level 1. 

Drops the other element off the 
stack. 

Begins the DO test-clause. 

Tests if flag —64 is set—if the 
index reached the end of the 
array. 

Ends the DO loop. 

Swaps the index to level 1 and 
drops it. Restores the last menu. 


(ENTER 1 Q MNX fSTOl 


Stores the program in MNX . 
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Checksum: # 57179d 
Bytes: 210.5 


Example: Find the maximum element of the following matrix: 

‘12 56' 

45 1 

9 14 


Enter the matrix. 

fr»l[ MATRIX | 

12 [ENTER 1 56 (ENTER! (?) 
45 (ENTER1 1 (ENTER! 

9 [ENTER! 14 (ENTER! 
(ENTER! 


1 • [[ 12 56 3 


[ 45 1 3 
[ 9 14 33 


V E C T F; 

MfiTF; 

LIST 

HYP 

REAL 



Select the VAR menu and execute MNX . 


(VAR 1 HI 





Find the maximum element. 



Sort for MAX or MIN? 
2 * 

Is [[ 12 56 3 
[ 45 1 3 
[ 9 14 33 


2: [[ 12 56 3 [ 45 1... 
Is 56 


M NM 

! EMC 

DJ 

MULTI 

HE 

trtT 

MEDIA 

TIL E 


MNX2 (Minimum or Maximum Element—Version 2) 

Given an array on the stack, MNX. 2 finds the minimum or maximum 
element in the array. MNX2 uses a different approach than MNX: it 
executes OBJ—» to break the array into individual elements on the 
stack for testing, rather than executing GETI to index through the 
array. 


Level 1 

+ Level 2 

Level 1 

[[ array ]] 

+ [[ array ]] 

^rriax 0/rz min 
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Techniques used in MNX2 

■ FOR ... NEXT (definite loop). The initial counter value is 1. The 
final counter value is nm — 1, where nm is the number of elements 
in the array. The loop-clause contains the sort instructions. 

■ User flag for logic control. User flag 10 defines the sort: When flag 
10 is set, MNX2 finds the maximum element; when flag 10 is clear, 
it finds the minimum element. You determine the status of flag 10 
at the beginning of the program. 

■ Nested conditional. An IF ... THEN ... END conditional is nested 
in the FOR ... NEXT loop, and determines the following: 

□ Whether to maintain the current minimum or maximum element, 
or make the current element the new minimum or maximum. 

□ The sense of the comparison of elements (either < or >) based on 
the status of flag 10. 

■ Logical function. MNX2 executes XOR {exclusive OR) to test the 
combined state of the relative value of the two elements and the 
status of flag 10. 


Custom menu. MNX2 builds a custom menu that lets you choose 
whether to sort for the minimum or maximum element. Key 1, 
labeledsets flag 10. Key 2, labeled |lBl|i|||, clears flag 10. 
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MNX2 program listing 


Program: 


Comments: 



n 



11 




DO NT 




■c "ixr 

10 CF CONI 



TMEHU 


II i 


Sort for HA!=• 


PROMPT 


DUP 08J-* 



1 


■"= N H P u B J 


DROP * 1 


FOR n 








THEN 

SWAP 

END 


Defines the temporary option 


menu. !!fffi§| sets flag 10 and 


continues execution. iBSSI 

J Id I.J.dJi JJ I d I I II laJI Id I 

clears flag 10 and continues 
execution. 

Displays the temporary menu 
and a prompting message. 


Copies the array. Returns the 
individual array elements to 
levels 2 through 7im+l, and 
returns the list containing n 
and m to level 1. 

Sets the initial counter value. 

Converts the list to individual 
elements on the stack. 

Drops the list size, then 
calculates the final counter 
value (nm —l). 

Starts the FOR ... NEXT 

loop. 

Saves the array elements to be 
tested (initially the last two 
elements). Uses the last array 
element as the current 
minimum or maximum. 

Tests the combined state of 
the relative value of the two 
elements and the status of flag 
10 . 

If the new element is either 
less than the current 
maximum or greater than the 
current minimum, swaps the 
new element into level 1. 
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Program: 

DROP 
NEXT 
0 MENU 


f ENTER) Q MNX2 (STO~) 


Checksum: # 12277d 
Bytes: 200.5 


Comments: 

Drops the other element off 
the stack. 

Ends the FOR ... NEXT 

loop. 

Restores the last menu. 


Stores the program in MNX2. 


Example: Use MNX2 to find the minimum element of the matrix 
from the previous example: 


‘12 56 
45 1 

9 14 


Enter the matrix (or retrieve it from the previous example). 


fr»)f MATRIX) 

12 (ENTER) 56 (ENTER) (V) 
45 (ENTER) 1 (ENTER) 

9 (ENTER) 14 (ENTER) 
(ENTER) 


1= [[ 12 56 ] 
[ 45 1 ] 

[ 9 14 ]] 


VECTft 

MATF; 

LIST 

[ HYP 

REAL 

IDA 

m 


Select the VAR menu and execute MNX2. 


(VAR) 



Find the minimum element. 



Sort for MAX or MIN? 

2 : 

1: [[ 12 56 ] 

C 45 1 ] 

C 9 14 ]] 


MAX MIN 


2: [[ 12 56 ] 

1 : 

13 


[ 45 1... 

1 


MNH2 MNK EXCQ MULTI Z 



MEDIA 
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Applying a Program to an Array 

A PLY makes use of list processing to transform each element of an 
array according to a desired procedure. The input array must be 
numeric, but the output “array” may be symbolic. Since arrays 
cannot actually contain symbolic objects, a convention for symbolic 
“pseudo-arrays” is used. Each row of elements is grouped into a single 
list and the set of rows is grouped into a list. For example, a 2 x 2 
pseudo-array looks like this: 

i C elemtntu ehmentiz > 

•C element 2 i element 22 J 

The procedure applied to each element must be a program that takes 
exactly one argument (i.e. the element) and returns exactly one result 
(i.e. the transformed element). 


Level 2 

Level 1 -*• 

Level 1 

[ array ] 

< program > -> 

[[ array ]] or {{ array }} 


Techniques used in APLY 

■ Manipulating Meta-Objects. Meta-objects are composite objects like 
arrays and lists that have been disassembled on the stack. APLY 
illustrates several approaches to manipulating the elements and 
dimensions of such objects. 

■ Application of List Processing. APLY makes use of DOSUBS 
(although DOLIST might also have been used) to perform the 
actual transformation of array elements. 

■ Using an IFERR .,, THEN .,. ELSE ... END Structure. The 
entire symbolic pseudo-array case is handled within a error 
structure—triggered when the —^ARRY command generates an error 
when symbolic elements are present. 

■ Using Flags. User flag 1 is used to track the case when the input 
array is a vector. 
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APLY program listing 


Program: Comments: 


■* a p 


1 CF 


■d D U P 

CT7C 

I 111 

D'lJP S 

IZE 

IF 1 

= — 

THEN 

1 SF 1 

SWAP 

U E> • J 

J 1 

i + 

ROLL 

ELSE 

DROP 2 

END D 

U F ! U B J 

SNAP 

OVER 2 

ROLLD 

*LIST 

1 p D 

OS UBS 


OBJ* DROP 


0 B • J ^ 


Store the array and program in 
local variables. 

Begin the main local variable 
structure. 

Make sure the flag 1 is clear to 
begin the procedure. 

Retrieve the dimensions of the 
array. 

Determine if the array is a 
vector. 

If array is a vector,set flag 1 and 
add a second dimension by 
treating the vector as an n x 1 
matrix. 

Disassemble the original vector, 
leaving the element count, n , in 
level L 

Roll the elements up the stack 
and bring the “matrix 55 
dimensions of the vector to level 
1. 

If array is a matrix, clean up 
the stack and decompose the 
matrix into its elements, leaving 
its dimension list on level 1. 

Duplicate the dimension list 
and compute the total number 
of elements. 

Roll up the element count and 
combine all elements into a list. 
Note that the elements in the 
list are in row-major order. 
Recalls the program and uses it 
as an argument for DOSUBS 
(DOLIST works in this case as 
well). Result is a list of 
transformed elements. 
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Program: 

OBJ* i + ROLL 


IFERR 


IF 1 FS? 

THEN OBJ* DROP *LIST 


END * FIRRY 


THEN 
0 B J * 

IF 1 F C ? C 
THEN DROP 
END * n m 






* L 1ST 


EVflL 

ROLLD 


NEXT 
n * LI y T 


Comments: 

Disassembles the result list and 
brings the array dimensions to 
level 1. 

Begins the error-trapping 

structure* Its purpose is to find 
and handle the cases when the 
result list contains symbolic 
elements. 

Was original array a vector? 

If the original array was a 
vector, then drop the second 
dimension (i) from the 
dimension list. 

Convert the elements into a 
array with the given dimensions. 
If there are symbolic elements 
present, an error will be 
generated and the error-clause 
which follows will be executed. 
Begin the error clause. 

Put the array dimensions on 
levels 2 and 1. If the array is a 
vector, level 1 contains a 1. 

Is original array a matrix? Clear 
flag 1 after performing the test. 
Drop the number of matrix 
elements. * 

Store the array dimensions in 
local variables. 

Begin local variable structure 
and initiate FOR..NEXT loop 

for each row. 

Collect a group of elements into 
a row (a list). 

Computes the number of 
elements to roll so that the next 
row can be collected. 

Repeat loop for the next row. 

Gather rows into a list, forming 
a list of lists (symbolic 
pseudo-array). 


Programming Examples 2-31 



Program: 


END 1 CF 



[ENTER ) □ APLY fSTOl 

Checksum: ^ 49768d 
Bytes: 319 


Comments: 

Close the local variable 
structure and end the 
IFERR..'THEN..END structure. 
Clear flag 1 before exiting the 
program. 


Stores the program in APLY . 


Example: Apply the function, f(x) = Ax 3 — 7 to each element x of 
the vector [3-24-8 1 ]. 


SI (ED 3 fspcl 2 TO 4 fspcl 8 fro 1 

(enter! 

3 O A © 7 F) (ENTER) 


(var) iBffiiil 


S3. 


Is { { 1 27*R-7 1 } { 
C8*fl)-7' } £ 1 64*R- 
7' > £ '-C512*H?-7' 
} £ 1 R—7 1 } > 


HE:*:' PPiiF; MEDIA FIBDN hPLV *F;PN 


Converting Between Number Bases 

§BASE converts a positive decimal number (z) into a tagged string 

representation of the equivalent value in a different number base (6). 
Both x and b must be real numbers. nBASE automatically rounds 
both arguments to the nearest integer. 


Level 2 

Level 1 

■+ Level 1 

X 

b 

■+ x based; " string” 
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Techniques used in nBASE 

■ String Concatenation and Character Manipulation. nBASE makes 
use of several string and character manipulation techniques to build 
up the result string. 

■ Tagged Output. nBASE labels (“tags”) the output string with its 
original arguments so that the output is a complete record of the 
command. 

■ Indefinite Loops. nBASE accomplishes most of its work 
using indefinite loops—both DO..UNTIL..END and 
WHILE..REPEAT..END loops. 


nBASE program listing 

Program: 

1 CF @ RND SNAP 0 RND 
b n 

■£ 

n LOG b LOG / 

10 RND 

IP n 0 

* i ft k 


Comments: 

Clear flag 1 and round both 
arguments to integers. 

Store the base and number in 
local variables. 

Begin the outer local variable 
structure. 

Computes the ratio of the 
common logarithms of number 
and base. 

Rounds result to remove 
imprecision in last decimal 
place. 

Find the integer part of log 
ratio, recall the original number, 
and initialize the counter 
variable k for use in the 

DO..UNTIL loop. 

Store the values in local 
variables. 
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Program: 

Comments: 


Begin inner local variable 

II II 

structure, enter an empty string 

DO 

and begin the 

DO..UNTIL..END loop. 

1 r*i' EVflL b i 

Compute the decimal value of 

’ k 1 EVflL - 

the (i — k)th. position in the 
string. 

DUPE MOD 

Makes a copy of the arguments 
and computes the decimal value 
still remaining that must be 
accounted for by other 
positions. 

IF DUP 0 == 

Is the remainder zero and 

'n' EVflL b i 

o ki r*i 

m > 6? 

nnt 1 

THEN I SF 

If the test is true, then set flag 

1. 

Store the remainder in m. 

END ' n 1 STD 

IF 

Compute the number of times 
the current position-value goes 
into the remaining decimal 
value. This is the “digit” that 
belongs in the current position. 

IF DUP 10 ^ 

Is the “digit” > 10? 

THEN 55 + CHR 

Then convert the digit into a 
alphabetic digit (such as A, B, 

C, ... ). 

END + 

Append the digit to the current 

* k 1 1 STO+ 

result string and increment the 
counter variable k. 
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Program: 

UNTIL 1 n' EVRL 9 


END 

IF 1 F S?C 
THEN 0 + 


WHILE i 'k' EVRL 
- 0 * 


REPERT 0 + 


k' STO+ 


END 


END 


" base" b + 


n b 


■ + -j 


Comments: 

Repeat the DO,,UNTIL loop 

until 777 — 0 (i.e. all decimal 
value has been accounted for). 

Is flag 1 set? Clear the flag after 
the test. 

Then add a placeholder zero to 
the result string. 

Begin WHILE..REPEAT loop 
to determine if additional 
placeholder zeros are needed. 
Loop repeats as long as i ^ k. 
Add an additional placeholding 
zero and increment k before 
repeating the test-clause. 

End the 

WHILE..REPEAT..END loop, 
the IF..THEN..END structure, 
and the inner local variable 
structure. 

End the outermost 

IF..THEN..ELSE..END 

structure and create the label 
string and tag the result string 
using the original arguments. 


ENTER] Q nBASE (STO 


Stores the program in nBASE . 


Checksum: # 36427d 
Bytes: 416.5 


Example: Convert lOOOio to base 23. 
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Verifying Program Arguments 

The two utility programs in this section verify that the argument to a 
program is the correct object type. 

■ NAMES verifies that a list argument contains exactly two names. 

■ VFY verifies that the argument is either a name or a list containing 

exactly two names. It calls NAMES if the argument is a list. 

8 

You can modify these utilities to verify other object types and object 
content. 


NAMES (Check List for Exactly Two Names) 

If the argument for a program is a list (as determined by VFY)> 
NAMES verifies that the list contains exactly two names. If the list 
does not contain exactly two names, an error message appears in the 
status area and program execution is aborted. 


Level 1 

-> Level 1 


{ valid list } 



{ invalid list } 

+ (error message in status area ) 



Techniques used in NAMES 

■ Nested conditionals. The outer conditional verifies that there are 
two objects in the list. If so, the inner conditional verifies that both 
objects are names. 

■ Logical functions. NAMES uses the AND command in the inner 
conditional to determine if both objects are names, and the NOT 
command to display the error message if they are not both names. 
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NAMES program listing 

Program: 

IF 

OBJ* 

DUP 2 SflME 

THEN 

DROP 

IF 

TYPE 6 SAME 

SWAP TYPE 6 SflME 

AND 


HOT 

THEN 

"Li si needs two nanes" 

DOERR 

END 


ELSE 

DRGPN 

"Illegal list 
DOERR 





(ENTER 1 Q NAMES fsTol 


Comments: 

Starts the outer conditional 
structure. 

Returns the n objects in the list 
to levels 2 through (n + 1), and 
returns the list size n to level 1. 
Copies the list size and tests if 
it’s 2. 

If the size is 2, moves the 
objects to levels 1 and 2, and 
starts the inner conditional 
structure. 

Tests if the first object is a 
name: returns 1 if so, otherwise 
0 . 

Moves the second object to level 
1, then tests if it is a name 
(returns 1 or 0). 

Combines test results: Returns 
1 if both tests were true, 
otherwise returns 0. 

Reverses the final test result. 

If the objects are not both 
names, displays an error 
message and aborts execution. 

Ends the inner conditional 
structure. 

If the list size is not 2, drops the 
list size, displays an error 
message, and aborts execution. 

Ends the outer conditional. 


Stores the program in NAMES. 
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Checksum: 

Bytes: 


# 40666d 
141.5 


NAMES is demonstrated in the program VFY. 

VFY (Verify Program Argument) 

VFY verifies that an argument on the stack is either a name or a list 
that contains exactly two names. 


Level 1 

1 name 1 —► 

{ valid list } —+ 

{ invalid fist } —*■ 
invalid object —► 


Level 1 

*name' 

{ valid list } 

{ invalid list } (and error message in status area ) 
invalid object (and error message in status area ) 


Techniques used in VFY 

■ Utility programs. VFY by itself has little use. However, it can be 
used with minor modifications by other programs to verify that 
specific object types are valid arguments. 

■ CASE .,. END (case structure). VFY uses a case structure to 
determine if the argument is a list or a name. 

■ Structured programming. If the argument is a list, VFY calls 
NAMES to verify that the list contains exactly two names. 

■ Local variable structure. VFY stores its argument in a local 
variable so that it can be passed to NAMES if necessary. 

■ Logical function. VFY uses NOT to display an error message. 

Required Programs 

■ NAMES (page 2-36) verifies that a list argument contains exactly 
two names. 


2-38 Programming Examples 



VFY program listing 


Program: 

•*: 

DUP 

DTAG 


arm 

CASE 

arm TYPE 5 SAME 
THEN 

a r 9 pi N A M E S 
END 

arm TYPE 6 SAME NOT 
THEN 

“Not na v \e or list" 
DGERR 
END 
END 


ENTER) Q VFY fSTO] 

Checksum: # 36796d 
Bytes: 139.5 


Comments: 

Copies the original argument 
■ 

to leave on the stack. 

Removes any tags from the 
argument for subsequent 
testing. 

Stores the argument in local 
variable argm . 

Begins the defining procedure. 
Begins the case structure. 

Tests if the argument is a list. 
If so, puts the argument back 
on the stack and calls NAMES 
to verify that the list is valid, 
then leaves the CASE 

structure. 

Tests if the argument is not a 
name. if so, displays an error 
message and aborts execution. 

Ends the CASE structure. 

Ends the defining procedure. 

Enters the program, then 
stores it in VFY . 


Example: Execute VFY to test the validity of the name argument 
BEN . (The argument is valid and is simply returned to the stack.) 


Q BEN f ENTER 1 
(VAR) 


"I”: irfi 1 ! . 

■ | ; '■ ! /"aV.fcV 

■'■'■I■ iWrV.VT'.V.v"' L .V 

i.. I .-..v.v. J.vr.v V 


l! 




nhme nnwb hi nemcd multi 


'BEN' 
m 
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Example: Execute VFY to test the validity of the list argument 
{ BEN JEFF SARAH }. Use the name from the previous example, 
then enter the names JEFF and SARAH and convert the three names 
to a list. 

Q JEFF (ENTER) 

Q SARAH (ENTER 


I 




Execute VFY. Since the list contains too many names, the error 
message is displayed and execution is aborted. 



Converting Procedures from Algebraic to RPN 


This section contains a program, —>RPN, that converts an algebraic 
expression into a series (list) of objects in equivalent RPN order. Note 
that -*RPN is a program provided with the TEACH command. You 



Techniques used in —>RPN 

■ Recursion. The —>RPN program calls itself as a subroutine. This 
powerful technique works just like calling another subroutine as long 
as the stack contains the proper arguments before the program calls 
itself. In this case the level 1 argument is tested first to be sure that 
it is an algebraic expression before —>RPN is called again. 
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■ Object Type-Checking. —►RPN uses conditional branching that 

depends on the object type of the level 1 object, 

■ Nested Program Structures. —^RPN nests IF ... THEN ... END 

structures inside FOR ... NEXT loops inside a IF ... THEN ... 
ELSE ... END structure. 

■ list Concatenation. The result list of objects in RPN order is 
built by using the ability of the + command to sequentially 
append additional elements to a list. This is a handy technique for 
gathering results from a looping procedure. 


—>RPN program listing 

Program: 

0 B J ■* 

IF OVER 
THEN 4 n f 

i n 
FOR i 

IF DUP TYPE 9 SRME 


THEN 

*RPN 

END n 

RQLLD 

NEXT 


IF DUP 

TYPE 

THEN 1 

*LIST 

END 



Comments: 

Take the expression apart. 

If the argument count is 
nonzero, then store the count 
and the function. 

Begins local variable defining 
procedure. 

Begins FOR ... NEXT loop, 
which converts any algebraic 
arguments to lists. 

Tests whether argument is an 
algebraic. 

If argument is an algebraic, 
convert it to a list first. 

Roll down the stack to prepare 
for the next argument. 

Repeat the loop for the next 
argument. 

Tests to see if level 1 object is a 
list. 

If not a list, then convert it to 
one. 

Ends the IF ... THEN ... 

END structure. 
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Program: 



W ft- 

iV 


Comments: 

Tests to see if there is more 
than one argument. 

Combine all of the arguments 
into a list. 

Append the function to the end 
of the list. 

End the local variable defining 
procedure. 

For functions with no 
arguments > converts to a simple 
list. 

End the IF ... THEN ... 

ELSE ... END structure. 


Checksum: # 28598d 
Bytes: 189.5 


Example: Convert the following algebraic expression to a series of 
objects in RPN syntax: ' Fi* C0 S < B +-f < C D > > -X "'3 1 . 


□ A ® B GD CD S) O c 0 

D © © 0 X 03 f ENTER 1 


is { RBCD-^T + C0S 
* H 3 A - } 


N E= H L“ 

PPhF; | 

MEDIA 

FIDDN 

APLY 

*F;PN 
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Bessel Functions 


This section contains a program. BER. that calculates the real part 
Ber n (x) of the Bessel function J n (xe 3lTl f 4 ). When n = 0, 


Ber(x) — 1 


(z/2) 4 _ ( x/2 ) 8 


* * * 


2! 2 


4! 2 



Level 1 

■* Level 1 


Z 

4 Ber(z) 


Techniques used in BER 

■ Local variable structure. At its outer level, BER consists solely of a 
local variable structure and so has two properties of a user-defined 
function: it can take numeric or symbolic arguments from the stack, 
or it can take arguments in algebraic syntax. However, because 
BER uses a DO ... UNTIL ... END loop, its defining procedure 

is a program. (Loop structures are not allowed in algebraic 
expressions.) Therefore, unlike user-defined functions, BER is not 
differentiable. 

■ DO .. . UNTIL .., END loop (indefinite loop with counter). BER 
calculates successive terms in the series using a counter variable. 
When the new term does not differ from the previous term to within 
the 12-digit precision of the calculator, the loop ends. 

■ Nested local variable structures. The outer structure is consistent 
with the requirements of a user-defined function. The inner 
structure allows storing and recalling of key parameters. 
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BER program listing 

Program: 


1 







u r-'i 




u n 


st»+C-1 


xo yerii'H 




E V fl L 

2 1 j' STO+ 

DUP ' sun 1 STO 
UNTIL 




{ENTER 1 Q BER (STO) 


Comments: 

Creates local variable x. 

Begins outer defining procedure. 

Enters x/2 } the first counter 
value, and the first term of the 
series, then creates local 
variables. 

Begins inner defining procedure. 
Begins the loop. 

Recalls the old sum and 
calculates the new sum. 

i* - 


Increments the counter. 

Stores the new sum. 

Ends the loop clause. 

Tests the old and new sums. 
Ends the loop. 

Recalls the sum. 

Ends inner defining procedure. 
Ends outer defining procedure. 

Stores the program in BER. 


Checksum: # 36388d 
Bytes: 200.5 


Example: Calculate Ber(3). 






Calculate Ber(2) in algebraic syntax. 



1= .751734182714 


i E E f; 

y f v 

NAME 

MNM 

2 

MN 

i,i 

i'i 

EMC 
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Animation of Successive Taylor’s Polynomials 

This section contains three programs that manipulate graphics objects 

to display a sequence of Taylor’s polynomials for the sine function. 

■ SINTP draws a sine curve, and saves the plot in a variable. 

■ SETTS superimposes plots of successive Taylor’s polynomials on 
the sine curve plot from SINTP , and saves the resulting graphics 
objects in a list. 

■ TSA uses the ANIMATE command to display in succession each 
graphics object from the list built in SETTS . 


SINTP (Converting a Plot to a Graphics Object) 

SINTP draws a sine curve, returns the plot to the stack as a graphics 
object, and stores that graphics object in a variable. Make sure your 
calculator is in Radians mode. 

Techniques used in SINTP 

■ Programmatic use of PLOT commands. SINTP uses PLOT 
commands to build and display a graphics object. 
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SINTP program listing 


Program: 


Comments: 


' SIN Of 5 1 STEQ 


FUNCTION 


1 O . I 

' 1 



4 ■ n 



dup neg mm 


* I ■ D 


YRNG 


ERASE DRAW 


PICT RCL 'SINT* STO 


S'. 


(enter! □ SINTP fsTo") 


Stores the expression for sin x in 

EQ. 

Sets the plot type and x- and 
^-axis display ranges. 

Erases PICT , then plots the 
expression. 

Recalls the resultant graphics 
object and stores it in SINT. 

Stores the program in SINTP. 


Checksum: # 197Id 
Bytes: 91.5 


SINTP is demonstrated in the program TSA. 

SETTS (Superimposing Taylor’s Polynomials) 

SETTS superimposes successive Taylor ? s polynomials on a sine curve 

and stores each graphics object in a list. 

Techniques used in SETTS 

■ Structured programming. SETTS calls SINTP to build a sine curve 
and convert it to a graphics object. 

■ FOR ... STEP (definite loop). SETTS calculates successive 
Taylor s polynomials for the sine function in a definite loop. The 
loop counter serves as the value of the order of each polynomial. 

■ Programmatic use of PIOT commands. SETTS draws a plot of 
each Taylor’s polynomial. 

■ Manipulation of graphics objects. SETTS converts each Taylor ? s 
polynomial plot into a graphics object. Then it executes -f to 
combine each graphics object with the sine curve stored in SINT , 
creating nine new graphics objects, each the superposition of a 
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Taylor’s polynomial on a sine curve. SETTS then puts the nine new 
graphics objects, and the sine curve graphics object itself, in a list. 

SETTS program listing 


Program: 


Comments: 


SINTP 


i 17 FOR n 


1 



i g 


* 



1 


i' n TfiYLR 


STEQ ERRSE DRAW 
PICT RCL SINT + 



SINT 

10 +LIST 

'TSL 1 STO 


Plots a sine curve and stores the 
graphics object in SINT, 

Sets the range for the FOR loop 
using local variable n. 

Plots the Taylor’s polynomial of 
order n. 

Returns the plot to the stack as a 
graphics object and executes + to 
superimpose the sine plot from 

SINT, 

Increments the loop counter n by 
2 and repeats the loop. 

Puts the sine curve graphics 
object on the stack, then builds a 
list containing it and the nine 
graphics objects created in the 
loop. Stores the list in TSL, 


(ENTER) CD SETTS (STO) Stores the program in SETTS, 

Checksum: 28102d 

Bytes: 138.5 

SETTS is demonstrated in the program TSA. 


TSA (Animating Taylor’s Polynomials) 

TSA displays in succession each graphics object created in SETTS, 


Techniques used in TSA 

■ Passing a global variable. Because SETTS takes several minutes to 
execute, TSA does not call SETTS, Instead, you must first execute 
SETT’S to create the global variable TSL containing the list of 
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graphics objects. TSA simply executes that global variable to put 
the list on the stack. 

■ FOR ... NEXT (definite loop). TSA executes a definite loop to 
display in succession each graphics object from the list. 

TSA program listing 

i- 

Program: 

v. 

TSL OBJ* 

■C t #8 #8 } .5 8 > + 

RHIMRTE 
11 DROPN 

§■ 

(ENTER ) Q TSA (STOl 

Checksum: # 59350d 
Bytes: 96.5 

Example: Execute SETTS and TSA to build and display in 

succession a series of Taylor’s polynomial approximations of the sine 
function. 

Set Radians mode and execute SETTS to build the list of graphics 
objects. (SETTS takes several minutes to execute.) Then execute 
TSA to display each plot in succession. The display shows TSA in 
progress. 



Comments: 

Puts the list TSL on the stack 
and converts it to 10 graphics 
objects and the list count. 

Set up the parameters for 

ANIMATE. 

Displays the graphics in 
succession. 

Removes the graphics objects and 
list count from the st ack. 

Stores the program in TSA. 
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Press (CANCEL) to stop the animation. Press (^tUrad) to restore 
Degrees mode. 


Programmatic Use of Statistics and Plotting 

This section describes a program PIE you can use to draw pie charts, 

PIE prompts for single variable data, stores that data in the statistics 

matrix E DAT. then draws a labeled pie chart that shows each data 

point as a percentage of the total. 

Techniques used in PIE 

■ Programmatic use of PLOT commands. PIE executes XRNG and 
YRNG to define x- and y -axis display ranges in user units, and 
executes ARC and LINE to draw the circle and individual slices. 

■ Programmatic use of matrices and statistics commands. 

■ Manipulating graphics objects. PIE recalls PICT to the stack and 

executes GOR to merge the label for each slice with the plot. 

■ FOR ... NEXT (definite loop). Each slice is calculated, drawn, and 
labeled in a definite loop. 

■ CASE .,. END structure. To avoid overwriting the circle, each 
label is offset from the midpoint of the arc of the slice. The offset 
for each label depends on the position of the slice in the circle. The 
CASE ,.. END structure assigns an offset to the label based on the 
position of the slice. 

■ Preserving calculator flag status. Before specifying Radians mode, 
PIE saves the current flag status in a local variable, then restores 
that status at the end of the program. 

■ Nested local variable structures. At different parts of the process, 
intermediate results are saved in local variables for convenient recall 
as needed. 

■ Temporary menu for data input. 
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PIE program listing 


Program; 


Comments: 





TM 

EHU 






" K 

P U I. i 

Hi m 

a] 

. U 

|I»I 1 

m ■ 

■ HI 

BBt . 

Ill 

i rrf o 

If L 

ICE? 

■ [ 

l“*. 

Ml 

•'■I 


re 

s t a r 

f. ■: 

V HI 

M-fe 

> 

P r o 

grar-'ii, " 

PR 

DM FT 






ER 

RSE 

X 

1 

■ i 

fj 

1 

XRHG 

i 

64 V 

RNG 

| 

~;l 

LCD 

ii p 

1 e a s 


w 


it 

a b c ® 

Dr 

a m i n 

Q 

■ P 

p 

i e 

Chart 11 

1 

flf 

DIS P 






( s 

H ii „“V“ 

‘I 

a 

a 

o 

a 

! u „ 

y 

0 

£ o o 


PC LI TOT 


DUP 180 * 
* p r c n t 


Recalls the current flag status 
and stores it in variable flags. 

Sets Radians mode. 

Defines the input menu: Key 1 
executes E+ to store each data 
point in EDAT, key 3 clears 
EDAT > and key 6 continues 
program execution after data 
entry. 

Displays the temporary menu. 

Prompts for inputs. 

■ represents the newline 
character ( XrR[<—*1 ) after you 
enter the program on the stack. 

Erases the current PICT and 
sets plot parameters. 

Displays “drawing” message. 


Draws the circle. 

Displays the empty circle. 
Recalls the statistics data 

matrix, computes totals, and 
calculates the proportions. 
Converts the proportions to 
percentages. 

Stores the percentage matrix in 
p rents. 


it # H U M ¥■ "fr 


Multiplies the proportion 
matrix by 27 t> and enters the 
initial angle (0). 
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Program: 

* prop angle? 

•*: 

prop SIZE OBJ* 

DROP SNRP 
FOR n 

<66? 32 > prop n GET 
’angle 1 ST0+ 

angle COS angle SIN 
R*C 28 * OVER + 

LINE 

PICT RCL 

angle prop n GET 
2 - DUP DUP 

COS SNRP SIN R*C 

■u ■■ h a M AM A 

dt * fob ? 3d > + 

SNRP 

CRSE 

DUP 1.5 4 
THEN 
DROP 
END 

DUP 4.4 4 
THEN 


Comments: 

Stores the angle matrix in prop 
and angle in angle. 

Sets up 1 to m as loop counter 
range. 

Begins loop-clause. 

Puts the center of the circle on 
the stack, then gets the nth 
value from the proportion 
matrix and adds it to angle. 
Computes the endpoint and 
draws the line for the nth slice. 

Recalls PICT to the stack. 

For labeling the slice, computes 
the midpoint of the arc of the 
slice. 

Starts the CASE structure to 
test angle and determine the 
offset value for the label. 

From 0 to 1.5 radians, doesn’t 
offset the label. 


From 1.5 to 4.4 radians, offsets 
the label 15 user units left. 


D R 0 P 






THEN 

i'' o 

*■. ■_> ? 

END 

END 


From 4.4 to 5 radians, offsets 
the label 3 units right and 2 
units up. 

Ends the CASE structure. 
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Program: 


prcnts n GEl 
1 RND 

*8TR "S'" * 


1 •frUR U B 


GOR DUP PICT STG 


+LCD 

NEXT 


> PVlEW 


Comments: 

Gets the nth value from the 
percentage matrix, rounds it to 
one decimal place, and converts 
it to a string with 
appended. 

Converts the string to a 
graphics object. 

Adds the label to the plot and 
stores the new plot. 

Displays the updated plot. 

Ends the loop structure. 
Displays the finished plot. 




TOF 



0 MENU 


(ENTER) 0 PIE fSTOl 

Checksum: # 1177d 
Bytes: 765 


Restores the original flag status. 

Restores the previous menu. 
(You must first press (CANCEL) 
to clear the plot.) 

Stores the program in PIE. 


Example: The inventory at Fruit of the Vroom, a drive-in fruit 
stand, includes 983 oranges, 416 apples, and 85 bananas. Draw a pie 
chart to show each fruit’s percentage of total inventory. 




Key 
DRfiW 

3 
2 

1 


SLICE 


values into SLICE* 
restarts program- 



CLEAR 



[i F; H M 
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Clear the current statistics data. (The prompt is removed from the 
display.) Key in the new data and draw the pie chart. 



983 

416 


85 


ISSfif 


i u a 

-.wi, 


1 ^ 


■ ■ lIi L ■ ■ ■ l 

j 1 ■■■ 1 lii ii lit ■ 

- ■ - . L .BL . . k . . !| | I J 

- - f "i * 


J.’.V.V.V.I.'.VJ.'.V.V. 

lj■ ■ ' ■_!| ■ ■ ■ ■ ■ L* ■ 




Press [CANCEL] to return to the stack display. 


Trace Mode 

This section contains two programs, a ENTER and RENTER, which 
together provide “trace mode for the HP 48 using an external printer. 
To turn on “trace mode,” set flag —63 and activate User mode. To 
turn off “trace mode,” clear flag —63 or turn off User mode. 


Techniques used in aENTER and RENTER 

■ Vectored ENTER. Setting flag —63 and activating User mode turns 
on vectored ENTER. When vectored ENTER is turned on and 
variable aENTER exists, the command-line text is put on the stack 
as a string and aENTER is evaluated. Then, if variable (3ENTER 
exists, the command that triggered the command-line processing is 


put on the stack as a string and 

aENTER program listing 

Program: 

■E 

PR I 
OBJ* 

[ENTER] 0 aENTER [$TO] 


RENTER is evaluated. 


Comments: 

Prints the command line text, 
then converts the string to an 
object and evaluates it. 

Stores the program in aENTER. 
(Press (a) frH A to type a. You 
must use this name.) 
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Checksum: # 51789d 

Bytes: 25.5 


RENTER program listing 

Program: Comments: 


PR1 DROP 
PRSTC 


(ENTER 1 CD RENTER fSTOl 


Prints the command that caused 
the processing, then drops it and 
prints the stack in compact form. 

Stores the program in (3ENTER. 
(Press (al fr*) B to type /?. You 
must use this name.) 


Checksum: # 3763Id 
Bytes: 28 


Inverse-Function Solver 

This section describes the program ROOTR , which finds the value of 
x at which f(x) — y. You supply the variable name for the program 
that calculates f(x), the value of y , and a guess for x (in case there 
are multiple solutions). 


Level 3 

Level 2 

Level 1 

■+ Level 1 

1 function name 1 

y 

Xguess 

-+ X 


Techniques used in ROOTR 

■ Programmatic use of root-finder. ROOTR executes ROOT to find 
the desired value. 

■ Programs as arguments. Although programs are commonly named 
and then executed by calling their names, programs can also be put 
on the stack and used as arguments to other programs. 
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ROOTR program listing 


Program: 


■ 

f t i“i 3 P‘1 

y m a 1 u e 

X 9 U 0 S 

*■ 

■ ■ 



x g uess 

’ XTEMP 1 

STO 

■*: XTEMP 

f n a pi e 


yoalue 

1 XTEMP 1 

xguess 

ROOT 

- 


1 w 
ft. ft 

O' 

1 XTEMP 1 ! 

PURGE 



ENTER j Q ROOTR [STO] 


Comments: 

Creates local variables. 

Begins the defining procedure. 

Creates variable XTEMP (to be 
solved for). 

Enters program that evaluates 

/(«) - y■ 

Enters name of unknown variable. 
Enters guess for X TEMP . 

Solves program for XTEMP . 

Ends the defining procedure. 
Purges the temporary variable. 

Stores the program in ROOTR. 


Checksum: # 13007d 
Bytes: 163 


Example: Assume you often work with the expression 

3.7sr 5 -f 4.5x 2 + 3.9a? + 5 and have created the program X^FX to 

calculate the value: 



You can use ROOTR to calculate the inverse function. 


Example: Find the value of x for which X —*FX equals 599.5. Use a 
guess in the vicinity of 1. 

Start by keying in X —» FX : 



(x) x fpl 3 (T) 4.5 (x) x f 2 
(±) 3.9 (x) x (+) 5 [ENTER] 


i HOME 1 

3= 

1= « * x '3.7*x A 3+4.5* 
x^S+S-^x+S 1 * 


RDDTf; £=ENT lo:ENT IDhT PIE 
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Store the program in X—>FX ) then enter the program name, the 
y -value 599.5, and the guess 1, and execute ROOTR : 


0 X—>FX fsTol 

O fVARl g ( ENTER 1 

599.5 (ENTER 1 1 HUB 


{ HOME > 





FiDDTRi £ENT o:ENT I 



PIE 


Animating a Graphical Image 

Program WALK shows a small person walking across the display. 

It animates this custom graphical image by incrementing the image 

position in a loop structure. 

Techniques used in WALK 

■ Custom graphical image. (Note that the programmer compiles 
the full information content of the graphical image before writing 
the program by building the image interactively in the Graphics 
environment and then returning it to the command line.) 

■ FOR ... STEP (definite loop). WALK uses this loop to animate 
the graphical image. The ending value for the loop is MAXR. 
Since the counter value cannot exceed MAXR, the loop executes 
indefinitely. 
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WALK program listing 


Program: 

•m m 

.v 

■ m 
* P 

GROB 9 15 E300 
1400i5001C001400E300 
3000C1 1 0 H fi 0094009000 
4100220014i02300 


* w a 1 k 

<k 

ERASE -C # 0d # 0d > 

PVIEW 

■C # 0d # 25d 15- 
PI CT OVER walk GXOR 

5 MflXR FOR i 

i 131 MOD R+B 
# 25d 2 tLIST 


PICT OVER wait GXOR 


PICT ROT walk GXOR 



.V 

[ENTER] Q WALK fSTQl 

Checksum: # 18146d 
Bytes: 240.5 


Comments: 

Puts the graphical image of the 
walker in the command line. 

(Note that the hexadecimal 
portion of the graphics obj ect is a 
continuous integer E3@@ ... 

2300. The linebreaks do not 
represent spaces.) 

Creates local variable walk 
containing the graphics object. 

Clears PICT , then displays it. 

Puts the first position on the 
stack and turns on the first 
image. This readies the stack and 
PICT for the loop. 

Starts the loop to generate 
horizontal coordinates 
indefinitely. 

Computes the horizontal 
coordinate for the next image. 
Specifies a fixed vertical 
coordinate. Puts the two 
coordinates in a list. 

Displays the new image > leaving 
its coordinates on the stack. 

Turns off the old image, removing 
its coordinates from the stack. 
Increments the horizontal 
coordinate by 5. 


Stores the program in WALK, 


Programming Examples 2-57 






Example: Send the small person out for a walk. 
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Command Reference 


This chapter contains an alphabetical listing of the programmable 
commands and functions available on the HP 48. The listings include 
the following information: 

■ a brief definition of what the command or function does 

■ a stack diagram showing the arguments it requires (if any) 

■ the keys to press to gain access to it 

■ any flags that may affect how it works 

■ additional information about how it works and how to use it 

■ an example of its use 

■ related commands or functions 

The next few pages explain how to read the stack diagrams in the 
command reference, how commands are alphabetized, and the 
meaning of the command classifications at the upper right corner of 
each stack diagram. 

How to Read Stack Diagrams 

Each entry in the command reference includes a stack diagram . This 
is a table showing the arguments that the command, function, or 
analytic function takes from the stack and the results that it returns 
to the stack. The character in the table separates the arguments 
from the results. The stack diagram for a command may contain more 
than one “argument —» result” line, reflecting all possible combinations 
of arguments and results for that command. 
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Consider this example: 


ACOS 

Arc Cosine Analytic Function: Returns the value of the angle having 

the given cosine. 



Level 1 


Level 1 


Z 

'symb 1 


arc cos z 
1 ACOS(symb)' 


This diagram indicates that the analytic function ACOS (Arc Cosine) 
takes a single argument from level 1 and returns one result (to level 
1). ACOS can take either a real or complex number or an algebraic 
object as its argument. In the first case, it returns the numeric 
arccosine; in the second, it returns the symbolic arccosine expression of 
the argument. 

Some commands affect a calculator state—a mode, a reserved variable, 
a flag, or a display— without taking any arguments from the stack or 
returning any results to the stack. No stack diagrams are shown for 
these commands. 

Parallel Processing with Lists 

Commands that can use the parallel list processing feature are 
denoted by the “{ }” symbol located above the stack diagram. This 
feature is discussed in greater detail in Appendix G. 

As a rule-of-thumb, a command can use parallel list processing if all 
the following are true: 

■ The command checks for valid argument types. Commands that 
apply to all object types, such as DUP, SWAP, ROT, and so forth, 
do not use parallel list processing. 

■ The command takes exactly one, two, three, four, or five arguments, 
none of which may itself be a list. Commands, such as —^LIST, 
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that have an indefinite number of arguments do not use parallel list 
processing. 

■ The command isn’t a programming branch command (IF, FOR, 
CASE, NEXT, and so forth). 

The HP 48 also has a few commands (PURGE and DELKEYS 
are examples) that have list processing capability built into their 
definitions, and so do not also use the parallel list processing feature. 

How Commands Are Alphabetized 

Commands appear in alphabetical order. Command names that 
contain special (non-alphabetic) characters are organized as follows: 

■ For commands that contain both special and alphabetic characters: 

□ A special character at the start of a command name is ignored. 

Therefore, the command *H follows the command GXOR and 
precedes the command HALT. 

n A special character within or at the end of a command name is 
considered to follow “Z” at the end of the alphabet. Therefore, 
the command R—>B follows the command RSD and precedes the 
command R— >C. 

■ Commands that contain only special characters appear at the end of 
the dictionary. 

Classification of Operations 

The command dictionary contains HP 48 commands } functions, and 
analytic functions. Commands are calculator operations that can 
be executed from a program. Functions are commands that can be 
included in algebraic objects. Analytic functions are functions for 
which the HP 48 provides an inverse and a derivative. There are also 
four non-programmmable operations (DBUG, NEXT, SST, and SSTj) 
that are included with the programmable commands as a convenience 

because they are used interactively while programming. 

The definitions of the abbreviations used for argument and result 
objects are contained in the following table, “Terms Used in Stack 
Diagrams.” Often, descriptive subscripts are added to convey more 
information. 
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Terms Used in Stack Diagrams 


Term 

Description 

arg 

Argument . 

[ array ] 

Real or complex vector or matrix . 

: [ C- array ] 

Complex vector or matrix. 

date 

Date in form MM.DDYYYY or DD.MMYYYY. 

{ dim } 

List of one or two array dimensions (real numbers) . 

' global 1 

Global name. 

grab 

Graphics obj ect . 

HMS 

A real-number time or angle in hours-minutes-seconds 
format . 

{ list } 

List of objects. 

local 

Local name. 

. [[ matrix .]] 

Real or complex matrix. 

n or m 

Positive integer real number (rounded if noninteger) . 

import ITCffl?7iebackup 

Backup identifier. 

• ^port ^library 

Library identifier. 


Binary integer. 

{ } 

Pixel coordinates. (Uses binary integers.) 

1 name 1 

Global or local name. 

ohj 

Any obj ect . 

PICT 

Current graphics object. 

< -program > 

Program. 

C R-array ] 

Real vector or matrix. 

"sfmip" 

Character string. 

1 1 

Expression, equation, or name treated as an algebraic. 

T/F 

Test result used as an argument: zero (false) or non-zero 
(true)real number. 

0/1 

Test result returned by a command: zero (false) or one 
(true). 

fzm e 

Time in form HH.MMSSs. 

[ vector ] 

Real or complex vector. 

r or 

Real number. 

a:_ unit 

Unit object, or a real number treated as a dimensionless 
obj ect . 

(z,y) 

Complex number in rectangular form, or user-unit 
coordinate. 

z 

Real or complex number. 
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ABS 


ABS 

Absolute Value Function: Returns the absolute value of its 

argument. 



Level 1 

X 

(*,y) 

x_ unit 
[ array ] 
'symb' 


Level 1 


yi 2 + y 2 
\x\-iinit 

II array || 
’ABS(symb)' 


Keyboard Access: 


.IJJIIJIIB-B ■ - r ■ ■ I s ■ r ■ ■ —I ■ "1^ .. -Min l 

fMTHi ■am (nxt i mstm 


(Whi ini®! mat ii 

I . 1 .. 


VJI^* 


fMTiTlfMXT) 




[mihjIEETR 

■ ■ 1 . 




■(■*■-.--r-r 


Affected by Flags: Numerical Results (—3) 


Remarks: ABS has a derivative (SIGN) but not an inverse. 

In the case of an array, ABS returns the Frobenius (Euclidean) norm 
of the array, defined as the square root of the sum of the squares of 

the absolute values of all n elements. That is, 



Related Commands: NEG, SIGN 
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Acknowledge Alarm Command: Acknowledges the oldest past-due 

alarm. 


Keyboard Access: f^ilfTiMEl w i iffiPt 


Affected by Flags: Repeat Alarms Not Rescheduled (—43) 
Acknowledged Alarms Saved (—44) 


Remarks: ACK clears the alert annunciator if there are both no 
other past-due alarms and no other active alert sources (such as a low 
battery condition). 


ACK has no effect on control alarms. Control alarms that come due 
are automatically acknowledged and saved in the system alarm list. 


Related Commands: ACKALL 


ACKALL 


Acknowledge All Alarms Command: Acknowledges all past-due 

alarms. 


Keyboard Access: 


Qum) 



9 * 9 9 9 " ■ P 


• r - f rfVanj* 1 ' "ft J J i"' J ■ 

i . J i ■■ ■■ 1 S i J J -|J1 . . g gfl ■ > - I 

t. i 


Affected by Flags: Repeat Alarms Not Rescheduled (—43) ? 
Acknowledged Alarms Saved (—44) 


Remarks: ACKALL clears the alert annunciator if there are no other 
active alert sources (such as a low battery condition). 

ACKALL has no effect on control alarms. Control alarms that come 
due are automatically acknowledged and saved in the system alarm 
list. 


Related Commands: ACK 
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ACOS 


ACOS 

Arc Cosine Analytic Function: 

the given cosine. 

Returns the value of the 

angle having 

{} 

Level 1 

Level 1 


Z 

~+ arc cos z 


' symb 1 

—► 'ACOS (symb)' 



Keyboard Access: f^fAcosI 

Affected by Flags: Principal Solution (—1), Numerical Results (—3), 
Angle Mode (—17, —18) 

Remarks: For a real argument x in the domain —l<x<l, the 
result ranges from 0 to 180 degrees (0 to tt radians; 0 to 200 grads). 

A real argument outside of this domain is converted to a complex 
argument z — x + Oi, and the result is complex. 

The inverse of COS is a relation , not a function, since COS sends 
more than one argument to the same result. The inverse relation for 
COS is expressed by ISOL as the general solution 


i 



1 *fiCG 




ir*nl 


t 


The function ACOS is the inverse of a part of COS, a part defined by 
restricting the domain of COS such that 1) each argument is sent to 
a distinct result, and 2) each possible result is achieved. The points 
in this restricted domain of COS are called the principal values of the 
inverse relation. ACOS in its entirety is called the principal branch of 
the inverse relation, and the points sent by ACOS to the boundary of 
the restricted domain of COS form the branch cuts of ACOS. 


The principal branch used by the HP 48 for ACOS was chosen because 
it is analytic in the regions where the arguments of the real-valued 
inverse function are defined. The branch cut for the comp lex-valued 
arc cosine function occurs where the corresponding real-valued 
function is undefined. The principal branch also preserves most of the 
important symmetries. 


Command Reference 3-7 





ACOS 


The graphs below show the domain and range of ACOS. The graph of 
the domain shows where the branch cuts occur: the heavy solid line 
marks one side of a cut, while the feathered lines mark the other side 
of a cut. The graph of the range shows where each side of each cut is 
mapped under the function. 


These graphs show the inverse relation 1 si*flCOS<Z>+S*TT*nl 5 for 
the case si —1 and nl — 0. For other values of si and ni, the vertical 
band in the lower graph is translated to the right or to the left. Taken 
together, the bands cover the whole complex plane, which is the 
domain of COS, 


View these graphs with domain and range reversed to see how the 
domain of COS is restricted to make an inverse function possible. 
Consider the vertical band in the lower graph as the restricted domain 
Z = < x , y >. COS sends this domain onto the whole complex plane in 
the range W = < u ? v > = COS Car? y‘> in the upper graph. 

Related Commands: ASIN, ATAN, COS, ISOL 
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ACOSH 


ACOSH 

Inverse Hyperbolic Cosine Analytic Function: Returns the inverse 

hyperbolic cosine of the argument. 


{} 


Level 1 


Level 1 

Z 

-4 

acosh Z 

'symb 1 

- 

‘ACOS H(sy/??£>)’ 


fMTin Hum 

L ■■■■■■ i i ii i iieai ib 

■ i i 


1:1 IH 


Keyboard Access: _ 

Affected by Flags: Principal Solution (—1), Numerical Results (—3) 

Remarks: For real arguments \x\ < 1, ACOSH returns the complex 
result obtained for the argument (sr, 0). 

The inverse of ACOSH is a relation, not a function, since COSH sends 
more than one argument to the same result. The inverse relation for 
COSH is expressed by ISOL as the general solution 


sl*nC0SH<Z)+2*ff*i*nl' 


The function ACOSH is the inverse of a part of COSH, a part defined 
by restricting the domain of COSH such that 1) each argument is sent 
to a distinct result, and 2) each possible result is achieved. The points 
in this restricted domain of COSH are called the principal values of 
the inverse relation. ACOSH in its entirety is called the principal 
branch of the inverse relation, and the points sent by ACOSH to the 
boundary of the restricted domain of COSH form the branch cuts of 

ACOSH. 

The principal branch used by the HP 48 for ACOSH was chosen 
because it is analytic in the regions where the arguments of the 
real-valued inverse function are defined. The branch cut for the 
complex-valued hyperbolic arc cosine function occurs where the 
corresponding real-valued function is undefined. The principal branch 
also preserves most of the important symmetries. 

The graphs below show the domain and range of ACOSH. The graph 
of the domain shows where the branch cut occurs: the heavy solid line 
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ACOSH 


marks one side of the cut. while the feathered lines mark the other 
side of the cut. The graph of the range shows where each side of the 
cut is mapped under the function. 


These graphs show the inverse relation 1 s 1 * ft COSH < Z > •+■ 2+11 * i *n I 
for the case sl~ 1 and nl —0. For other values of si and nl , the 
horizontal half-band in the lower graph is rotated to the left and 
translated up and down. Taken together, the bands cover the whole 
complex plane, which is the domain of COSH. 


View these graphs with domain and range reversed to see how the 
domain of COSH is restricted to make an inverse function possible. 
Consider the horizontal half-band in the lower graph as the restricted 
domain Z = < x ? y '). COSH sends this domain onto the whole complex 
plane in the range W = C u ? v > = COShKxji y > in the upper graph. 


Related Commands: ASINH, ATANH, COSH, ISOL 
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ADD 

Add List Command: Adds corresponding elements of two lists or 

adds a number to each of the elements of a list. 


{} 


Level 2 


Level 1 


Level 1 


{ list i } 

{ list } 

°bJr\ o n -list 


{ } 

°bj\ n 0 n 

—list 

{ list } 


{ ^result } 

{ "'^result ) 
{ "'^result > 


Keyboard Access: [mth! UiliHI 



Affected by Flags: None 


Remarks: ADD executes the + command once for each of the 
elements in the list. If two lists are the arguments, they must have 
the same number of elements as ADD will execute the + command 
once for each corresponding pair of elements. If one argument is a 
non-list object, ADD will attempt to execute the + command using 
the non-list object and each element of the list argument, returning 
the result to the corresponding position in the result. (See the + 
command entry to see the object combinations that are defined.) If 
an undefined addition is encountered, a Bad Argument Type error 
results. 


Related Commands: ALIST, IILIST, ELIST 
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ALOG 


Common Antilogarithm Analytic Function: Returns the common 

antilogarithm; that is. 10 raised to the given power. 


Level 1 

—^ 

Level 1 

Z 

\ 

— * 

10* 

'sy/r?/?' 

- 

'ALOG (symb)' 


Keyboard Access: 

Affected by Flags: Numerical Results (—3) 
Remarks: For complex arguments: 

10( x,y ) — e cx cos cy + i e cx sin cy 
where c — In 10. 

Related Commands: EXP, LN, LOG 


AMORT 

Amortize Command: Amortizes a loan or investment based upon the 

current amortization settings. 

{} 


Level 1 

- Level 3 

Level 2 

Level 1 

n 

■+ principal 

interest 

balance 


Keyboard Access: 



Affected by Flags: Financial Payment Mode (—14) 
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Remarks: Values must be stored in the TVM variables ( I%YR, PV , 
PMT , and PYR). The number of payments n is taken from level 1 
and flag —14. 

Related Commands: TVM, TVMBEG, TVMEND, TVMROOT 

AND 

And Function: Returns the logical AND of two arguments. 


{} 


Level 2 

Level 1 

■* Level 1 

* n l 


■+ #«3 

" string 1 " 

" string 2 ” 

■4 " string 3 ” 

T/F, 

t/f 2 

■+ 0/1 

T/F 

'symb' 

■+ ' T/F AND symb' 

1 symb 1 

T/F 

■+ 'symb AND T/F' 

'symb 1 ' 

'symb 2 ' 

■+ t symb 1 AND symb 2 1 


Keyboard Access: 



Affected by Flags: Numerical Results (—3), Binary Integer Wordsize 
(—5 through —10) 

Remarks: When the arguments are binary integers or strings. AND 
does a bit-by-bit (base 2) logical comparison. 

■ An argument that is a binary integer is treated as a sequence of bits 
as long as the current wordsize. Each bit in the result is determined 
by comparing the corresponding bits (bit\ and bit 2 ) in the two 
arguments as shown in the following table: 
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biii 

bit2 

bU 1 AND bit 2 

0 

0 

0 

0 

1 

0 

1 

0 

0 

1 

1 

1 


■ An argument that is a string is treated as a sequence of bits, using 8 
bits per character (that is, using the binary version of the character 
code). The two string arguments must have the same number of 
characters. 

When the arguments are real numbers or symbolics, AND simply 
does a true/false test. The result is 1 (true) if both arguments are 
non-zero; it is 0 (false) if either or both arguments are zero. This test 
is usually done to compare two test results. 

It either or both of the arguments are algebraic expressions, then the 
result is an algebraic of the form 1 symb i RHD syrnb 2 1 . Execute -+ HUM 
(or set flag —3 before executing AND) to produce a numeric result 
from the algebraic result. 

Related Commands: NOT, OR, XOR 


ANIMATE 

Animate Command: Displays graphic objects in sequence. 


Level n+1...Level 2 

Level 1 

■+ Level 1 

grob n ...grob 1 

”g ro bs ~ 

■+ same stack 

grob n ,,.grob x 

{ n { #X #Y } delay rep } - 

■+ same stack 


Keyboard Access: 


fpRGi iiaiiii fNXTi ifiiif 1 


Affected by Flags: None 
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Remarks: ANIMATE displays a series of graphics objects (or 

variables containing them) one after the other. You can use a list to 
specify the area of the screen you want to animate (pixel coordinates 
#X and #Y), the number of seconds before the next grob is displayed 
(delay), and the number of times the sequence is run (rep). If rep is 
set to 0, the sequence is played one million times, or until you press 
(CANCEL) . 

If you use a list on level 1, all parameters must be present. 

The animation displays PICT while displaying the grobs. The grobs 
and the animate parameters are left on the stack. 

Example: The following program draws half a cylinder and rotates it; 


PRRSURFRCE C 1 COS DO 1 1 


SIN CO ! V > 


STEQ 


* I 180 I + XXRNG ERASE DRAW PICT RCL 


* * 

rr 



SEQ OBJ* ANIMATE DROPN 


This program also illustrates the use of SEQ and PARSURFACE. 
You can adjust the increment value used with SEQ (8 is used here) 
to change the number of images drawn by the program, or to use less 
memory. 


APPLY 



Apply to Arguments Function: Creates an expression from the 

specified function name 

and arguments. 


Level 2 

Level 1 

Level 1 

{ symb r ... $ymb n } 

' name ' —*■ 

1 name^symbi ... symb n ) * 

Keyboard Access: 

llf SYMBOLIC I fN! 

<t) l-ilw 
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APPLY 


Affected by Flags: None 

Remarks: A user-defined function f that checks its arguments for 
special cases often can’t determine whether a symbolic argument x 
represents one of the special cases. The function / can use APPLY to 
create a new expression ' f < x > 1 . If the user now evaluates 


4 -' t 


is evaluated before /, so the argument to / will be the result obtained 
by evaluating 

The algebraic syntax for APPLY is this: 


1 flPPLYt names symb\ ? ... * symb n ) 1 

When evaluated in an algebraic expression, APPLY evaluates the 
arguments (to resolve local names in user-defined functions) before 
creating the new object. 

Example: The following user-defined function Asin is a variant 
of the built-in function ASIN. Asin checks for special numerical 
arguments. If the argument on the stack is symbolic (the second case 
in the case structure), Asin uses APPLY to return the expression 
‘ fls i n i argument ) 1 . 




argument 




C H b E 

-3 FS? THEN argument HSIN END 




9 I:- argument, TYPE POS 


THEN 1 flPPLY<Osin,argument>' EVflL END 


' argument==1 1 THEN 
' argument==-1 1 THEN 
argument FIS IN 


TT 


i i 


END 


TT 


v V 1 


END 


END 


* k 






(ENTER) Q Asin f'STO) 


Related Commands: QUOTE, 
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ARC 


Draw Arc Command: Draws an arc in PICT counterclockwise from 

* 

xq to xq 2 , with its center at the coordinate specified in level 4 and its 
radius specified in level 3. 


Level 4 

Level 3 

Level 2 

Level 1 

—> 

Level 1 

(z, y ) 

£ radius 

x 6i 

X 02 



{#« #™} 

^ ^-radius 

x 9i 

X 02 




Keyboard Access: 


fPRGl III 

u “ ■ ■ ■ • i r l i- l ■ Lit; i 



Affected by Flags: Angle Mode (—17 and -18) 

The setting of flags —17 and —18 determine the interpretation of xg 

and xq 2 (degrees, radians, or grads). 

Remarks: ARC always draws an arc of constant radius in pixels, 
even when the radius and center are specified in user-units, regardless 
of the relative scales in user-units of the x~ and y- axes. With user-unit 
arguments, the arc starts at the pixel specified by (z, y ) 4- (a, 6), 
where (a, b) is the rectangular conversion of the polar coordinate 
(^radius? x 0i)' The resultant distance in pixels from the starting point 
to the center pixel is used as the actual radius, r\ The arc stops at 
the pixel specified by (r 1 , xg 2 ). 

If x@ 1 — xg 2 , ARC plots one point. If \xg x — xg 2 \ > 360 degrees, 2w 
radians, or 400 grads, ARC draws a complete circle. 

Example: In Degrees mode, with the x-axis display range (XRNG) 
specified as —6.5 to 6.5, the command sequence <0 ? 9> 1 0 96 ARC 
draws an arc counterclockwise from 0 to 90 degrees with a constant 
radius of 10 pixels. 


Related Commands: BOX, LINE, TLINE 
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ARCHIVE 

Archive HOME Command: Creates a backup copy of the HOME 

directory (that is, all variables), the user-key assignments, and the 
alarm catalog in the specified backup object (: n por t “ name) in 
independent RAM. 


Level 1 

— Level 1 

:n port .name 

- 

:IO : name 

I 


Keyboard Access: h-iHmemory 

1 (NXTlSm 

Affected by Flags: I/O Device (- 

-33), I/O Messages (-39) if the 


argument is s I Os name 

Remarks: The specified port number can be 0 through 33. The port 
used (except 0) must be configured as independent RAM. (See FREE.) 
An error will result if there is not enough independent RAM in the 
specified port to copy the HOME directory. 

If the backup object is s 10s name, then the copied directory is 
transmitted in binary via Kermit protocol through the current I/O 
port to the specified filename. 

To save flag settings, execute RCLF and store the resulting list in a 
variable. 

Related Commands: RESTORE 
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ARRY-> 


ARG 


Argument Function: Returns the ( 

real) polar angle 9 of a complex 

number #>. 



{> 

Level 1 -f 

Level 1 

(x,y) 

e 

1 symb 1 —► 

'ARG (symb)' 




Keyboard Access: [mthj [nxtj 1111118 llli 

*h i— m m i — in* ' - ' ' ' 

Affected by Flags: Angle mode (—17, —18) 

Remarks: The polar angle 6 is equal to: 
arc tan y/x for x > 0 

arc tan yfx + i r sign y for x < 0, Radians mode 
arc tan y/x + 180 sign y for x < 0, Degrees mode 
arc tan y/x + 200 sign y for x < 0, Grads mode 
A real argument x is treated as the complex argument <#, 0 



ARRY-+ 

Array to Stack Command: Takes an array and returns its elements 

as separate real or complex numbers. Also returns a list of the 
dimensions of the array. 


Level 1 

. Level nm+1 ... Level 2 

Level 1 

[ vector ] 

Z^ , * * Zfl 

1 ^element J 

[[ matrix ]] 

z i i * ♦ * z n m 

{ "row m C ol } 
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ARRY—► 

Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: The command OBJ—+ includes this functionality. ARRY—* 
is included for compatibility with the HP 28S. ARRY—> is not in a 
menu. 

If the argument is an n-element vector, the first element is returned to 
level n + 1 (not level nm -fi 1), and the nth element to level 2. 

Related Commands: —►ARRY, DTAG, EQ->, LIST^, OBJ^, 
STR-> 


^ARRY 

Stack to Array Command: Returns a vector of n real or complex 
elements or a matrix of n x m real or complex elements. 


Level nm+1 ... Level 2 

Level 1 

- Level 1 

Z^ . . . Zp 

"element ~ 

* [ vector ] 

^11 * 1 * m 

{ n r0 w l1? col } 

* [[ matrix ]] 


Keyboard Access: 



Affected by Flags: None 

Remarks: The elements of the result array should be entered into the 
stack in row order, with zn (or z\) in level nm + 1 (or n + 1), and 
z nm (or z n ) in level 2. If one or more of the elements is a complex 
number, the result array will be complex. 


Related Commands: ARRY—►, LIST^, -►LIST, OBJ-*, STR 
-VTAG, —►UNIT 
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ASIN 

Arc Sine Analytic Function: Returns the value of the angle having 

the given sine. 



Level 1 


Level 1 



arc sin z 


'symb' 


'ASIN( symbY 


Keyboard Access: Q(MD 

Affected by Flags: Principal Solution (—l), Numerical Results (—3), 
Angle Mode (-17, -18) 

Remarks: For a real argument x in the domain —1 < x < 1, the 
result ranges from —90 to +90 degrees (—tt/ 2 to +7t/2 radians; —100 
to +100 grads). 

A real argument outside of this domain is converted to a complex 
argument 2 = x + 0z, and the result is complex. 

The inverse of SIN is a relation, not a function, since SIN sends more 
than one argument to the same result. The inverse relation for SIN is 
expressed by ISOL as the general solution 


i 


RSIN 


>*C-T >-'-nl+TT*nl 1 


The function ASIN is the inverse of a pari of SIN, a part defined by 
restricting the domain of SIN such that 1) each argument is sent to 
a distinct result, and 2} each possible result is achieved. The points 
in this restricted domain of SIN are called the principal values of the 
inverse relation. ASIN in its entirety is called the principal branch of 
the inverse relation, and the points sent by ASIN to the boundary of 
the restricted domain of SIN form the branch cuts of ASIN. 


The principal branch used by the HP 48 for ASIN was chosen because 
it is analytic in the regions where the arguments of the real-valued 
inverse function are defined. The branch cut for the comp lex-valued 
arc sine function occurs where the corresponding real-valued function 
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is undefined. The principal branch also preserves most of the 
important symmetries. 

The graphs below show the domain and range of ASIN. The graph of 
the domain shows where the branch cuts occur: the heavy solid line 
marks one side of a cut, while the feathered lines mark the other side 
of a cut. The graph of the range shows where each side of each cut is 
mapped under the function. 


These graphs show the inverse relation 'RSI M < Z > # ■- -1 > '"Ti i+iT*nl 1 
for the case nl —0. For other values of nl , the vertical band in the 
lower graph is translated to the right (for nl positive) or to the left 
(for nl negative). Taken together, the bands cover the whole complex 
plane, which is the domain of SIN. 


View these graphs with domain and range reversed to see how the 
domain of SIN is restricted to make an inverse function possible. 
Consider the vertical band in the lower graph as the restricted domain 
Z = < x -i y >. SIN sends this domain onto the whole complex plane in 
the range N = v ) = SIN< x * y > in the upper graph. 

Related Commands: ACOS, ATAN, ISOL, SIN 
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ASINH 

Arc Hyperbolic Sine Analytic Function: Returns the inverse 

hyperbolic sine of the argument. 


{} 


Level 1 

- 

Level 1 


Z 

-> 

asinh z 


' symb 1 

- 

'ASINH (symby 



Keyboard Access: 





Affected by Flags: Principal Solution (—1), Numerical Results (—3) 


Remarks: The inverse of SINH is a relation , not a function, since 
SINH sends more than one argument to the same result. The inverse 
relation for SINH is expressed by ISOL as the general solution 


I 


H 




nl+Tr*i*ni 


l 


The function ASINH is the inverse of a part of SINH, a part defined 
by restricting the domain of SINH such that 1) each argument is sent 
to a distinct result, and 2) each possible result is achieved. The points 
in this restricted domain of SINH are called the principal values of the 
inverse relation. ASINH in its entirety is called the principal branch of 
the inverse relation, and the points sent by ASINH to the boundary of 
the restricted domain of SINH form the branch cuts of ASIN H. 

The principal branch used by the HP 48 for ASINH was chosen 
because it is analytic in the regions where the arguments of 

the real-valued function are defined. The branch cut for the 
complex-valued ASINH function occurs where the corresponding 
real-valued function is undefined. The principal branch also preserves 
most of the important symmetries. 

The graph for ASINH can be found from the graph for ASIN (see 
ASIN) and the relationship asinh z — —i asin iz. 

Related Commands: ACOSH, ATANH, ISOL, SINH 
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Assign Command: Defines a single key on the user keyboard by 
assigning the given object to the key £k ey , which is specified as rc.p. 



Level 2 Level 1 Level 1 


obj 

x key 

SKEY' 

x key 



Keyboard Access: RtKmqdes) !||| 


I 



Affected by Flags: User-Mode Lock (—61) and User Mode (—62) 

affect the status of the user keyboard 


Remarks: The argument 2 ;key is a real number rc.p specifying the 
key by its row number r, column number c, and plane (shift) p . The 
legal values for p are as follows: 


Plane, p 

Shift 

0 or 1 

unshifted 

2 

left-shifted 

3 

© right-shifted 

4 

(q) alpha-shifted 

5 

(a) alpha left-shifted 

6 

© @ alpha right-shifted 


Once ASN has been executed, pressing a given key in User or 1-User 
mode executes the user-assigned object. The user key assignment 
remains in effect until the assignment is altered by ASN, STOKEYS, 
or DELKEYS. Keys without user assignments maintain their standard 
definitions. 

If the argument obj is the name 1 SKEY 1 , then the specified key is 
restored to its standard key assignment on the user keyboard. This 
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is meaningful only when all standard key assignments had been 
suppressed (for the user keyboard) by the command 1 S 1 DEL KEYS 
(see DELKEYS). 

To make multiple key assignments simultaneously, use STOKEYS. To 
delete key assignments, use DELKEYS. 

Be careful not to reassign or suppress the keys necessary to cancel 
User mode. If this happens, exit User mode by doing a system halt 
(“warm start”): press and hold fONl and the C key simultaneously, 
releasing the C key first. This cancels User mode. 

Example: Executing ASN with GET I in level 2 and 85- 3 in level 
1 assigns GETI to (r+) f” " 1 on the user keyboard. ( (t+) f” ”) has a 
location of 85.3 because it is eight rows down, five columns across, and 
right-shifted.) When the calculator is in User mode, pressing (7») f” ” ] 
now executes GETI (instead of executing [” ” 1 ). 

Related Commands: DELKEYS, RCLKEYS, STOKEYS 


ASR 

Arithmetic Shift Right Command: Shifts a binary integer one bit to 

the right, except for the most significant bit, which is maintained. 


{} 

Level 1 

■+ Level 1 



-*■ #n 2 



Keyboard Access: (mth) feiiSSl (TIxtI 




Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 

Remarks: The most significant bit is preserved while the remaining 
(wordsize— 1) bits are shifted right one bit. The second-most 
significant bit is replaced with a zero. The least significant bit is 
shifted out and lost. 
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ASR 


An arithmetic shift is useful for preserving the sign bit of a binary 
integer that will be shifted. Although the HP 48 makes no special 
provision for signed binary integers, you can still interpret a number 
as a signed quantity. 

Related Commands: SL, SLB, SR, SRB 


ATAN 


Arc Tangent Analytic Function: 

Returns the value of the angle 

having the given tangent. 



{> 

Level 1 

Level 1 

Z —► 

arc tan z 

'symb 1 —► 

'ATAN(symfo ) 1 


Keyboard Access: (4 tKatan) 

Affected by Flags: Principal Solution (—1), Numerical Results (—3), 
Angle Mode (—17, —18) 

Remarks: For a real argument, the result ranges from —90 to +90 
degrees (—tt/ 2 to +7r/2 radians; —100 to +100 grads). 

The inverse of TAN is a relation , not a function, since TAN sends 
more than one argument to the same result. The inverse relation for 
TAN is expressed by I SQL as the general solution 


l 


RTflN 



+Tr*n 1 


! 


The function ATAN is the inverse of a part of TAN, a part defined by 
restricting the domain of TAN such that 1) each argument is sent to a 
distinct result, and 2) each possible result is achieved. The points in 
this restricted domain of TAN are called the principal values of the 
inverse relation. ATAN in its entirety is called the principal branch of 
the inverse relation, and the points sent by ATAN to the boundary of 
the restricted domain of TAN form the branch cuts of ATAN. 
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The principal branch used by the HP 48 for ATAN was chosen because 
it is analytic in the regions where the arguments of the real-valued 
inverse function are defined. The branch cuts for the complex-valued 
arc tangent function occur where the corresponding real-valued 
function is undefined. The principal branch also preserves most of the 
important symmetries. 

The graphs below show the domain and range of ATAN. The graph of 
the domain shows where the branch cuts occur: the heavy solid line 
marks one side of a cut, while the feathered lines mark the other side 
of a cut. The graph of the range shows where each side of each cut is 
mapped under the function. 

These graphs show the inverse relation 1 flTRN<Z)+ir*nl 1 for the 
case nl — 0. For other values of nl , the vertical band in the lower 
graph is translated to the right (for nl positive) or to the left (for nl 
negative). Taken together, the bands cover the whole complex plane, 
which is the domain of TAN. 

View these graphs with domain and range reversed to see how the 
domain of TAN is restricted to make an inverse function possible. 
Consider the vertical band in the lower graph as the restricted domain 
Z = ixi y >. TAN sends this domain onto the whole complex plane in 
the range N = (,u 9 v > = TfiN<x ? y > in the upper graph. 

Related Commands: ACOS, ASIN, ISOL, TAN 
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Branch Cuts for ATAN(Z) 


ATANH 


Arc Hyperbolic Tangent Analytic Function: Returns the inverse 

hyperbolic tangent of the argument. 


{> 

Level 1 -* 

Level 1 

Z —► 

atanh z 

'symb' —► 

'ATANH (symb)' 


Keyboard Access: [ mth l 


W-.'t" 


■ ! ■ i ■ ■ 





Affected by Flags: Principal Solution (—1), Numerical Results (—3), 

Infinite Result Exception (—22) 
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Remarks: For real arguments |r| > 1, ATANH returns the complex 
result obtained for the argument (x, 0). For a real argument a;=±l, 
an Infinite Result exception occurs. If flag —22 is set (no error), 
the sign of the result (MAXR) matches that of the argument. 

The inverse of TANH is a relation, not a function, since TANH sends 
more than one argument to the same result. The inverse relation for 
TANH is expressed by ISOL as the general solution 

' RTRNhKZ>+rr*i*nl 1 

The function ATANH is the inverse of a pari of TANH, a part defined 
by restricting the domain of TANH such that 1) each argument is sent 
to a distinct result, and 2) each possible result is achieved. The points 
in this restricted domain of TANH are called the principal values of 
the inverse relation. ATANH in its entirety is called the principal 
branch of the inverse relation, and the points sent by ATANH to the 
boundary of the restricted domain of TANH form the branch cuts of 

ATANH. 

The principal branch used by the HP 48 for ATANH was chosen 
because it is analytic in the regions where the arguments of 
the real-valued function are defined. The branch cut for the 
comp lex-valued ATANH function occurs where the corresponding 
real-valued function is undefined. The principal branch also preserves 
most of the important symmetries. 

The graph for ATANH can be found from the graph for AT AN (see 
ATAN) and the relationship atanh z — —i at an iz. 

Related Commands: ACOSH, ASINH, ISOL, TANH 
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ATICK 

Axes Tick-Mark Command: Sets the axes tick-mark annotation in 
the reserved variable PPAR. 


Level 1 


#n 

{ *,y} 

{ #n #m } 


Level 1 


Keyboard Access: r*-nfPLoT) illili InxtI IBili 


Affected by Flags: None 


Remarks: Given x> ATICK sets the tick-mark annotation to x units 
on both the x- and the ?/-axis. For example, 2 would place tick-marks 
every 2 units on both axes. 


Given #n, ATICK sets the tick-mark annotation to #n pixels on both 
the x- and the y- axis. For example, #5 would place tick-marks every 
5 pixels on both axes. 

Given { x y }, ATICK sets the tick-mark unit annotation for each axis 
individually. For example, { 10 3 } would mark the x-axis at every 
multiple of 10 units, and the y -axis at every multiple of 3 units. 

Given { #n #m } ATICK sets the tick-mark pixel annotation for each 

axis individually. For example, {62} would mark the x-axis every 6 
pixels, and the y -axis every 2 pixels. 

Related Commands: AXES, DRAX 
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ATTACH 

Attach Library Command: Attaches the library with the specified 

number to the current directory. Each library has a unique number. If 
a port number is specified, it is ignored. 


{} 



Keyboard Access: f+Hf library) psixT) 11JI1 


Affected by Flags: 




Remarks: To use a library object, it must be in a port and it must 
be attached. A library object from an application card (ROM) is 
automatically in a port (1-33), but a library object copied into RAM 
(such as through the PC Link) must be stored into a port using STO. 

Many libraries are attached automatically when an application card is 
installed. Others require you to ATTACH them, as do many libraries 
copied into RAM. (The owner ? s manual for the application card or 
library will tell you which of its library objects must be attached 
manually.) You can also ascertain whether a library is attached to the 
current directory by executing LIBS. 

A library that has been copied into RAM and then stored (with STO) 
into a port can be attached only after the calculator has been turned off 
and then on again following the STO command. This action (off/on) 
creates a system halt , which makes the library object “attachable.” 

Note that it also clears the stack, local variables, and the LAST stack, 
and it displays the MATH menu, (To save the stack first, execute 
DEPTH *LIST 1 name 1 STO .) 

The number of libraries that can be attached to the HOME directory 
is limited only by the available memory. However, only one library 
at a time can be attached to any other directory. If you attempt to 
attach a second library to a non- IIOME directory, the new library will 
overwrite the old one. 
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ATTACH 

Related Commands: DETACH, LIBS 


AUTO 


AutOSCaEe Command: Calculates a y -axis display range , or an x- 
and y -axis display range. 


Keyboard Access: ® (plot) (mr) Hill 


Affected by Flags: None 


Remarks: The action of AUTO depends on the plot type as follows: 


Plot Type 

Scaling Action 

FUNCTION 

Samples the equation in EQ at 40 values of the 
independent variable, equally spaced through the 
x-axis plotting range, discards points that return 
±oo, then sets the y -axis display range to include 
the maximum, minimum, and origin. 

CONIC 

Sets the y-axis scale equal to the a:-axis scale. 

POLAR 

Samples the equation in EQ at 40 values of the 
independent variable, equally spaced through 
plotting range, discards points that return ±oo, 
then sets both the x- and y-axis display ranges in 
the same manner as for plot type FUNCTION. 

PARAMETRIC 

Same as POLAR, 

TRUTH 

No action. 

BAR 

Sets the x-axis display range from 0 to the number 
of elements in EDAT } plus 1. Sets the y-range to 
the minimum and maximum of the elements. The 
z-axis is always included. 
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Plot Type 

Scaling Action 

HISTOGRAM 

Sets the x-axis display range to the minimum and 
maximum of the elements in E DAT. Sets the 

2 /~axis display range from 0 to the number of rows 

in EDAT. 

SCATTER 

Sets the x-axis display range to the minimum and 
maximum of the independent variable column 
(XCOL) in EDAT. Sets the y-axis display range to 
the minimum and maximum of the dependent 
variable column (YCOL). 


AUTO does not affect 3D plots. 

AUTO actually calculates a y- axis display range and then expands 
that range so that the menu labels do not obscure the resultant plot. 

AUTO does not draw a plot—execute DRAW to do so. 

Example: The program « FUNCTION flUTO DRAW DRfiX » sets the 
plot type to FUNCTION, autoscales the y-axis, plots the equation in 
EQ , and adds axes to the plot. 

Related Commands: DRAW, *H, SCALE, SOLE, *W, XRNG, 
YRNG 


AXES 

Axes Command: Specifies the intersection coordinates of the x- and 
#-axes, tick-mark annotation, and the labels for the x- and y-axes. 
This information is stored in the reserved variable PPAR. 


Level 1 


Level 1 


(x, y) 

{ (x, y) atick " x-axis label " "y-axis label " } 
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AXES 


Keyboard Access: Q(£loT) jHH 
Affected by Flags: None 



Remarks: The argument for AXES (a complex number or list) is 
stored as the fifth parameter in the reserved variable PPAR. How the 
argument is used depends on the type of object it is: 


■ If the argument is a complex number, it replaces the current entry 

in PPAR. 


■ If the argument is a list containing any or all of the above variables, 
only variables that are specified are affected. 

atick has the same format as the argument for the ATICK command. 
This is the variable that is affected by the ATICK command. 

The default value for AXES is < 9 ? 0 >. 

Axes labels are not displayed in PICT until subsequent execution of 

LABEL. 


Example: The command sequence 






RXES LABEL 


specifies an axes intersection at < 0 s 9 >, tick-mark annotation every 2 

units, and puts the labels t- and y in PICT. The labels are positioned 
to identify the horizontal and vertical axes respectively. 

Related Commands: ATICK, DRAW, DRAX, LABEL 


BAR 

Bar Plot Type Command: Sets the plot type to BAR. 


Keyboard Access: 


f^lfPLOT ) fNXT ) 



Affected by Flags: None 

Remarks: When the plot type is BAR, the DRAW command plots a 

bar chart using data from one column of the current statistics matrix 
(reserved variable E DAT). The column to be plotted is specified 
by the XCOL command, and is stored in the first parameter of the 
reserved variable EPAR. The plotting parameters are specified in the 
reserved variable PPAR , which has the following form: 


3-34 Command Reference 










































BAR 


\ Xmin ? Vmin •* l ^max ? Vrnax 171 dep T6S dXtS ptype dtpCTld .■ 

For plot type BAR, the elements of PPAR are used as follows: 

■ ®min j Vmin is a complex number specifying the lower left corner of 
PICT (the lower left corner of the display range). The default value 

4 rr i - * a v 

is '.."b. 5 ? ~-=<. 1. 

■ < a? max , pm ax £ is a complex number specifying the upper right corner 
of PICT (the upper right corner of the display range). The default 
value is < 6.5 ? 3 ■ 2 >. 

■ indtp is either a name specifying a label for the horizontal axis, or a 
list containing such a name and two numbers, with the smaller of 
the numbers specifying the horizontal location of the first bar. The 
default value of indep is X. 

u res is a real number specifying the bar width in user-unit 

coordinates, or a binary integer specifying the bar width in pixels. 
The default value is 8, which specifies a bar width of 1 in user-unit 
coordinates. 

■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin., a list specifying the tick-mark annotation, and two 
strings specifying labels for the horizontal and vertical axes. The 
default value is < 8 ? 8 >. 

■ PtyP e is a command name specifying the plot type. Executing the 
command BAR places the command name BAR in PPAR. 

■ depend is a name specifying a label for the vertical axis. The default 
value is Y. 

A bar is drawn for each element of the column in SDAT. Its width 
is specified by res and its height is the value of the element. The 
location of the first bar can be specified by indep ; otherwise, the value 
in <£ m i n , y min is used. 

Related Commands: CONIC, DIFFEQ, FUNCTION, GRIDMAP, 
HISTOGRAM, PARAMETRIC, PARSURFACE, PCONTOUR, 
POLAR, SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, 
YSLICE 
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BARPLOT 


Draw Bar Plot Command: Plots a bar chart of the specified column 
of the current statistics matrix (reserved variable £ DAT). 


Keyboard Access: 


(4^1 STATl —II 


Affected by Flags: None 



Remarks: The data column to be plotted is specified by XCOL 
and is stored as the first parameter in reserved variable £ PAR. The 
default column is 1* Data can be positive or negative, resulting in bars 
above or below the axis. The jf-axis is autoscaled, and the plot type is 
set to BAR. 


When BARPLOT is executed from a program, the resulting plot does 
not persist unless PICTURE, PVIEW (with an empty list argument), 
or FREEZE is subsequently executed. 

Related Commands: FREEZE, HISTPLOT, PICTURE, PVIEW, 
SCATRPLOT, XCOL 


BAUD 

Baud Rate Command: Specifies bit-transfer rate. 


_ {} 

Level 1 Level 1 


a u d ra te 


Keyboard Access: 



Affected by Flags: None 


Remarks: Legal baud rates are 1200. 2400, 4800, and 9600 (default). 


For more information, refer also to the reserved variable IOPAR ( I/O 
parameters) in appendix D, “Reserved VariablesC 

Related Commands: CKSM, PARITY, TRANSIO 
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BESTFIT 


BEEP 

Beep Command: Sounds a tone at n hertz for x seconds. 


{} 


Level 2 

Level 1 

■+ Level 1 

^freq uency 

^duration 



Keyboard Access: (prgi(nxt) Mill* f nxt ) 

i# L J V M — —v/.-.v.-.v.-.v.-.v.-.v.:.v.v.-.v V 1 



Affected by Flags: Error Beep (—58) 


Remarks: The frequency of the tone is subject to the resolution of 
the built-in tone generator. The maximum frequency is approximately 
4400 Hz; the maximum duration is 1048.575 seconds. Arguments 

greater than these maximum values default to the maxima. 


Related Commands: HALT, INPUT, PROMPT, WAIT 


BESTFIT 

Best-Fitting Model Command: Executes LR with each of the 

four curve fitting models, and selects the model yielding the largest 
correlation coefficient. 


Keyboard Access: 


0(M) 



Affected by Flags: None 


Remarks: The selected model is stored as the fifth parameter in the 
reserved variable SPAR, and the associated regression coefficients, 
intercept and slope, are stored as the third and fourth parameters, 
respectively. For a description bf SPAR, see appendix D, “Reserved 
Variables.” 


Related Commands: EXPFIT, UNFIT, LOGFIT, LR, PWRFIT 
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Binary Mode Command: Selects binary base for binary integer 

operations. (The default base is decimal.) 


Keyboard Access: 



Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base ( — 11, —12) 


Remarks: Binary integers require the prefix #. Binary integers 
entered and returned in binary base automatically show the suffix b. 
If the current base is not binary, binary numbers can still be entered 
by using the suffix b (the numbers are displayed in the current base, 
however). 


The current base does not affect the internal representation of binary 
integers as unsigned binary numbers. 

Related Commands: DEC, HEX, OCT, STWS, RCWS 



Keyboard Access: Qfsw) :I|1IS1I iltilip 

^ ..PPPPPPPP . . 

Affected by Flags: None 

Remarks: BINS returns a matrix containing the frequency of 
occurrences in each bin, and a 2-element array containing the 
frequency of occurrences falling below or above the defined range of 
x- values. The array can be stored into the reserved variable EDAT 
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and used to plot a bar histogram of the bin data (for example, by 
executing BARPLOT). 


For each element x in EDAT, the nth bin count n treq bin n is 
incremented, where: 


ftfreq bin n 




•Emin 


■% width 


for ^ m j n ^ X ^ ^maxj where -^max — ^min d“ (^bins)(*^ width )* 

Example: If the independent column of EDAT contains the following 
data: 


7 


2314 6 9 0 1 135 13 2 6 9 5 b 


Him 

! E Li 


1 2 5 BINS returns [[51 [3] [ 5 ] C 2 3 [ 2 3 1 and [ 1 1 ]. 


The data has been sorted into 5 bins of width 2, starting at a?-value 1 
and ending at z-value 11. The first element of the matrix shows that 5 
^-values (21112) fell in bin 1, where bin 1 ranges from x -value 1 
through 2.99999999999. The vector shows that one z-value was less 

than £ mjn (0), and one was greater than x ma x (13). 

Related Commands: BARPLOT, XCOL 


BLANK 

Blank Graphics Object Command: Creates a blank graphics object 

of the specified width and height. 


{} 



Level 2 

Level 1 

Level 1 



# n w id th 

^^height 

9?ob b j a n k 



Keyboard Access: 
Affected by Flags: 
Related Commands: 





None 


GROB, LCD— 


* 
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BOX 

Box Command: Draws in PICT a box whose opposite corners are 
defined by the specified pixel or user-unit coordinates. 


{} 


Level 2 

Level 1 

—y 

Level t 

{ #«1 #^ 7 , } 

{ ^^2 ^^2 } 

- 


(*i , y 1 ) 

(*2 - ^2 ) 

- 



Keyboard Access: PprgI IBiif 
Affected by Flags: None 



Related Commands: ARC, LINE, TLINE 


BUFLEN 

Buffer Length Command: Returns the number of characters in the 
HP 48’s serial input buffer and a single digit indicating whether an 
error occurred during data reception. 


Level 1 


Level 2 Level 1 


rt 


chars 



Keyboard Access: 


S)(W)fNXT) 




Affected by Flags: None 


Remarks: The digit returned to level 1 is 1 if no framing, UART 
overrun, or input-buffer overflow errors occurred during reception, 
or @ if one of these errors did occur. (The input buffer holds up to 
255 bytes.) When a framing or overrun error occurs, data reception 
ceases until the error is cleared (which BUFLEN does); therefore, n 
represents the data received before the error. 
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BYTES 

Use ERRM to see which error has occurred when BUFLEN returns 6 
to level 1. 

Related Commands: CLOSEIO, OPENIO, SBRK, SRECV, STIME, 
XMIT 


BYTES 

Byte Size Command: Returns the number of bytes and the 

checksum for the given object. 


{} 


Level 1 

->■ 

Level 2 

Level 1 

obj 

- 

^^checksum 

*size 


Keyboard Access: 
Affected by Flags: 


Q (MEMORY) mm 

None 


Remarks: If the argument is a built-in object, then the size is 2.5 
bytes and the checksum is # 0. 

If the argument is a global name, then the size represents the name 
and its contents, while the checksum represents the contents only. The 
size of the name alone is (3.5 + 2 x n), where n is the number of 
characters in the name. 


Example: Objects that decompile identically can have different byte 
sizes and checksums. For instance, 

■C1 > 

and 


1 1 R 5 STD R O + 

both produce lists containing the number 1. However, the first list 
contains the built-in object 1 (for a size of 7.5 bytes), while the second 
list contains a RAM copy of 1 (for a size of 15.5 bytes). 

Related Commands: MEM 
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B-R 

Binary to Real Command: Converts a binary integer to its 

floating-point equivalent. 



Level 1 


Level 1 




Keyboard Access: 



Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 


Remarks: If # n > # 1000000000000 (base 10), only the 12 most 
significant decimal digits are preserved in the resulting mantissa. 


Related Commands: R—►B 


CASE 

CASE Conditional Structure Command: Starts CASE ... END 

conditional structure. 


Level 1 


Level 1 


THEN 

END 

END 


T/F 


■ jhK B H H| I - L i a ■ ■ ■ i ■■ ■■■ n t Ht rrrr -i— 1 t fc n» ■ ■ Hi ■ » ■ ■ ■ « «11 f r a ■- ■ n 1 m 1 1 1J.1 i ■ 1 1 «_i_i a 

Keyboard Access: Iprg) ami! I1IMSI Ill 

(Pr i i fa M i I I I I hbiihkeiiBis I BflF'I'lll'Ittasiei ■■ s' 

Affected by Flags: None 


IS 
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CASE 


Remarks: The CASE ... END structure executes a series of cases 
(tests). The first test that returns a true result causes execution of 
the corresponding true-clause, ending the CASE ... END structure. 

A default clause can also be included: this clause executes if all tests 
evaluate to false. 

The CASE ... END structure has this syntax: 

CASE 

test-clausei THEN irue-clausei END 

test-clause 2 THEN true-clause 2 END 
* 

+ 

♦ 

test-clause n THEN true-clause n END 
default-clause (optional) 

END 

When CASE executes, test-clause 1 is evaluated. If the test is true, 
true-clausex executes, then execution skips to END, If test-clause 1 is 
false, test-clause 2 executes. Execution within the CASE structure 
continues until a true clause is executed, or until all the test clauses 
evaluate to false. If the default clause is included, it executes if all test 
clauses evaluate to false. 

Example: The following program takes a numeric argument from the 
stack: 

■ if the argument is negative, it is added to itself 

■ if the argument is positive, it is negated 

■ if the argument is zero, the program aborts 


« CASE 


I KJ V 1 




THEN X NEG END 


' X< 0' 


THEN X DUP + END 


f — — i“-< I 




THEN 0 DOERR END 


END 
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CASE 



Related Commands: END, IF, IFERR, THEN 


CEIL 

Ceiling Function: Returns the smallest integer greater than or equal 
to the argument. 


Level 1 


n 


/?_ unit 
CEIL (symh) 


Level 1 


x_ unit 
1 symb 1 


Keyboard Access: [mth! iilR lS ( nxt ) fNXTl 9B 
Affected by Flags: Numerical Results (—3) 

Examples: 


v‘ » U. 


CEIL returns 4; ~3» 2 CEIL returns 


Related Commands: FLOOR, IP, RND, TRNC 


CENTR 

Center Command: Adjusts the first two parameters in the reserved 
variable PPAR , <£ min , # min > and <.x max , ?/ max >, so that the point 
represented by the argument y > is the plot center. 
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CF 

{} 


Level 1 

- 

Level 1 


(*, y) 

- 



i x 

- 




Keyboard Access: 


f^ilfPLOTl lililll (NXT1 

.... 


| J - M* P 1 , 

J a “ »-i»- - --J- ,, l 

■ t v 

■■ i F «■ ! I - 



Affected by Flags: None 


Remarks: The center pixel is in row 32, column 65 when PICT is its 
default size (131 x 64), 

If the argument is a real number x } CENTR makes the point <x, 0) 

the plot center. 

Related Commands: SCALE 


CF 

Clear Flag Command: Clears the specified user or system flag. 



Level 1 


n 


fiagnum ber 


Level 1 


Keyboard Access: 



r^TIlMODESi 



Affected by Flags: None 


Remarks: User flags are numbered 1 through 64. System flags are 
numbered —1 through —64. See appendix C, “System Flags,” for a 
listing of HP 48 system flags and their flag numbers. 


Related Commands: FC?, FC?C, FS?, FS?C, SF 


Command Reference 3-45 

















































CHOOSE 

Create User-Defined Choose Box Command: Creates a 

user-defined choose box. 


Level 3 Level 2 Level 1 -» Level 2 Level 1 

"prompt’ { c x ... c n } Up os —► obj or result “V 

"prompt" { c, ... c n } u po s -*■ “0” 


Keyboard Access: (prg!(nxTI 



Affected by Flags: None 


Remarks: CHOOSE creates a standard single-choice choose box 
based on the following specifications. 


Variable 

Func don 

“ prompt ” 

A message that appears at the top of choose 
box. If “ prompt ” is an empty string no 

message is displayed. 

{ Cl • * • Cn} 

Definitions that appear within the choose 
box. A choice definition ( c x ) can have two 
formats. 


■ obj, any object. 

■ { ob]display ob]result } 3 the object to be 
displayed followed by the result returned to 
the stack if that object is selected. 

Tlpos 

The position number of an item definition. 
This item is highlighted when the choose box 
appears. If 7i pos =0, no item is highlighted, 
and the choose box can be used to view items 
only. 


If you choose an item from the choose box and press tlSISlllj 
CHOOSE returns the result (or the object itself if no result is 
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%CH 


specified) to level 2 and 1 to level 1. If you press |illllll, 


CHOOSE 


returns 0. Also, if n 


pos 


0, CHOOSE returns 0. 


Example: CHOOSE with the following three lines on the display. 


11 Ss 10 C t 3 P r" O *3r 3 PI" 11 

■C C “Pie Chart " ■sPIE#} {" Inverse Function" «R00TR^> 
t"finimate Taylor" «T3R&> > 


would produce the following display. 


LHlSELECT A PROGRAM: 

4: 

3 5 Inverse Functi 
2s Animate Taylor 


Related Commands: INFORM, NOVAL 


%CH 

Percent Change Function: Returns the percent change from x (level 
2) to y (level 1) as a percentage of x. 

__________ {} 

Level 2 Level 1 Level 1 

X 

X 

'symb ' 

'symb l ' 
x^unit 
x_ unit 
'symb' 


symb' 


'symb 2 1 

y„ unit 
1 symb' 
X- unit 


100(y-x)/x 

'%Ch\(x t symb)' 

'%C H(symb,x)' 

'%CHCsym/?! ,symb 2 y 

1 0O(y_ unit-x _ u/?/'t)/x_ unit 
' % CH (x_ unit , symb )' 
, %CH(symd r x_un/t)' 
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%CH 


Keyboard Access: 




Affected by Flags: Numerical Results (—3) 


Remarks: If both arguments are unit objects, the units must be 
consistent with each other. The dimensions of a unit object are 
dropped from the result, but units are part of the calculation . 


For more information on using temperature units with arithmetic 
functions, refer to the keyword entry for +. 

Examples: 1 „m 50 0 _cm “;CH returns 480, because 500 cm 
represents an increase of 400% over 1 in. 


180 K 150 K 


v 


CH returns 50. 


Related Commands: %, %T 


CHR 

Character Command: Returns a string representing the HP 48 

character corresponding to the character code n . 


{} 

Level 1 

- Level 1 


n 

■+ ” string " 



Keyboard Access: 


Q (CHARS] 




Affected by Flags: None 


Remarks: The character codes are an extension of ISO 8859/1. 
Codes 128 through 159 are unique to the HP 48. See the entry for 
NUM for a complete list of characters and character codes. 


The default character « is supplied for all character codes that are not 
part of the normal HP 48 display character set. 
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CKSM 


Character code 0 is used for the special purpose of marking the end 
of the command line. Attempting to edit a string containing this 
character causes the error Can't Edit CHR<0>, 

You can use the CHARS application to find the character code for any 
character used by the HP 48, See “Keying in Special Characters” in 
chapter 2 of the HP ^8 User's Guide. 

Related Commands: NUM, POS, REPL, SIZE, SUB 


CKSM 

Checksum Command: Specifies the error-detection scheme. 



Level 1 



ecksum 



Level 1 


Keyboard Access: 



Affected by Flags: None 


Remarks: Legal values for rc checksurT1 are as follows 


■ 1: 1-digit arithmetic checksum. 

■ 2: 2-digit arithmetic checksum. 

■ 3: 3-digit cyclic redundancy check (default). 


The CKSM specified is the error-detection scheme that will be 
requested by KGET, PKT, or SEND. If the sender and receiver 
disagree about the request, however, then a 1-digit arithmetic 


checksum will be used. 


IR transmission should use checksum type 3. 

Related Commands: BAUD, PARITY, TRANSIO 


Command Reference 3-49 



























CLEAR 

Clear Command: Removes all objects from the stack. 


Level n ... Level 1 -► Level n ... Level 1 


Obj n . . . Obj-^ 


Keyboard Access: (+T)(clear) 

Affected by Flags: None 

Remarks: To recover a cleared stack, press fr*) IUNDOl before 
executing any other operation. There is no programmable command 
to recover the stack. 

Related Commands: CLVAR, PURGE 


CLKADJ 

Adjust System Clock Command: Adjusts the system time by x 

clock ticks, where 8192 clock ticks equal 1 second. 


{} 


Level 1 

-+ Level 1 


X 




Keyboard Access: 


f^nfTiMEjfMXTlfNXTl 



Affected by Flags: None 


Remarks: If X is positive, X clock ticks are added to the system time. 
If x is negative, x clock ticks are subtracted from the system time. 


Example: 88 CLKRDJ decrements the system time by 2.5 

seconds. 
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CLOSEIO 


Related Commands: —»TIME 


CLLCD 


Clear LCD Command: Clears (blanks) the stack display. 




• -■■■- ■ ■ 
-- 1 - I j IJJJ . s .1 


1 ,r J -is ■« ->1-J J J 4 a -A* 


Keyboard Access: IprgiInxt 1 
Affected by Flags: None 

Remarks: The menu labels continue to be displayed after execution 
of CLLCD. 


When executed from a program, the blank display persists only until 
the keyboard is ready for input. To cause the blank display to persist 
until a key is pressed, execute FREEZE after executing CLLCD. 
(When executed from the keyboard, CLLCD automatically freezes the 
display.) 

Example: Evaluating •£ CLLCD 7 FREEZE »■ blanks the display 
(except the menu labels), then freezes the entire display. 

Related Commands: DISP, FREEZE 


CLOSEIO 


Close I/O Port Command: Closes the serial port and the IR port, 

and clears the input buffer and any error messages for KERRM. 


Keyboard Access: g)Q/3 (nxt) 1!II1§ 


Affected by Flags: None 


Remarks: When the HP 48 turns off, it automatically closes the 
serial and IR ports, but does not clear KERRM. Therefore, CLOSEIO 
is not needed to close the ports, but can conserve power without 
turning off the calculator. 


Executing HP 48 Kermit protocol commands automatically clears 
the input buffer; however, executing non-Kermit commands (such as 

SRECV and XMIT) does not. 
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CLOSEIO 


CLOSEIO also clears error messages from KERRM. This can be useful 
when debugging. 

Related Commands: BUFLEN. OPENIO 


CL l 


Clear Sigma Command: Purges the current statistics matrix 
(reserved variable EDAT). 

Keyboard Access: f<hl[sTATl HI 
Affected by Flags: None 
Related Commands: RCLE, STOE, E+, E 


-■ ■ r r f ■ i r ■ 

lipfci'p-p. -n*- - -'t.VfPMI! p I I I i i >• 

i ■■•iiliP! i - - K - I.- JVi ■ ■ ■ i I 1* P I 

------ -f ■ j ■■■■(•ill 

i iilllni | • H * - “ I p-p----f V iiiii ii ! I 

ii «■! ■ ■ ■ ■ ■ - ■ - r-arfiini ilririi 

.. . 

i I ■ i I ! I I I ■ • ■ i ■ ■ ■ r r r r • 


CLTEACH 


Clear Teaching Examples Command: Removes the EXAMPLES 

subdirectory and its contents from the HOME directory. 

Keyboard Access: None. Must be typed in. 

Affected by Flags: None 
Related Commands: TE ACH 


CLUSR 

Clear Variables Command: Provided for compatibility with the HP 
28. CLUSR is the same as CLVAR. See CLVAR. 
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CLVAR 

Clear Variables Command: Purges all variables and empty 

subdirectories in the current directory. 

Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Related Commands: CLUSR, PGDIR, PURGE 


CNRM 

Column Norm Command: Returns the column norm (one-norm) of 
the array argument. 


{} 



Level 1 

- 

Level 1 


[ array ] 

- 

v 

colu m n norm 


Keyboard Access: 





■? i i -i i 
niiii 

■7.V, 

. .1 

■* I ! I f 
■•■Hi'” 



Affected by Flags: None 


Remarks: The column norm of a matrix is the maximum (over all 
columns) of the sum of the absolute values of all elements in each 
column. For a vector, the column norm is the sum of the absolute 
values of the vector elements. For complex arrays, the absolute value 

of a given element ( x , y) is + y 2 . 

Related Commands: CROSS, DET, DOT, RNRM 
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-COL 

Matrix to Columns Command: Transforms a matrix into a series 

of column vectors and returns the vectors and a column count, or 
transforms a vector into its elements and returns the elements and an 
element count. 


{} 


Level 1 

-f Level n+1 ... 

Level 2 

Level 1 

1 

[[ matrix ]] 

— [ vector ] coll 

[ vector ] coln 

^colco u n t 

[ vector ] 

—► element 

element n 

"elem entcou nt 


Keyboard Access: [mth) ll-BHH IBHi 

K. i > if* !• i * ' * ■* s- + - - ! + - -- -- -- -- -- ------------------ ■ - ! — i — ■■tjaammaaa- J - - J - J J • » ■ ■ ■ -.1- 


Affected by Flags: None 


Remarks: 


COL introduces no rounding error. 


Related Commands: COL 


COL+ 

Insert Column Command: Inserts an array (vector or matrix) into 

a matrix (or one or more elements into a vector) at the position 
indicated by n jndex , and returns the modified array. 


{} 


Level 3 

Level 2 

Level 1 -+ 

Level 1 

[[ matrix ]] x 

[ matrix ] 2 

n ] n d e x —¥ 

[[ matrix ]] 3 

[[ matrix ]] x 

[ vector ] CO | U m n ^index * 

[[ matrix ]] 2 

[ vector ] x 

^element 

n index 

[ vector ] 7 

Keyboard Access: (mth) i 

Willi ■BOll# *EP 

- - - - - -- 


Affected by Flags: None 
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COL- 

Remarks: The inserted array must have the same number of rows as 
the target array. 

7i\ n a ex is rounded to the nearest integer. The original array is 
redimensioned to include the new columns or elements, and the 
elements at and to the right of the insertion point are shifted to the 
right. 

Related Commands: COL- CSWP, ROW+, ROW- 


COL- 

Delete Column Command: Deletes column n of a matrix (or element 

n of a vector), and returns the modified matrix (or vector) and the 
deleted column (or element). 


{} 


Level 2 

Level 1 

Level 2 

Level 1 

[[ matrix ]] 3 

"column 

—► [[ matrix ]] 2 

[ vector ] column 

[ vector ] x 

# i e m e n t 

—► [ vector ] 2 

element^ 

Keyboard Access: (mth) 

■ i . n|n ilu ■ H|i i Hflif i 'fW' ■ ■ - - r .HI ■ -■ <IH i m|ii jii.j ijjii t. b . . . i i_fcl l . l ■ M# 

' 1 “ h.H ■ I - ■ 1 - “■ * ' ' - . ■ ■ ■ ■ - J ■ ■ j - 1 . . . t “ * - H - - 1 

ill ■ ill i ■ ill i Marinai ■ - r ■■■iMiililllll4 , iliaiJlkJii........ ....lbi . . 

mmMmm 

■ jl 1 1 1 1 11 li IdiJ jjji 

■ ill L_ ■ 1 . J J J J ■ J J J . . 

■ i RHH i-iii iiii--i 

■ ■ ■ ii ■ ■■1 ■ iBiBaaBBi 


Affected by Flags: None 

Remarks: n is rounded to the nearest integer. 

Related Commands: COL+, CSWP, ROW+, ROW- 
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COL—► 

Columns to Matrix Command: Transforms a series of column vectors 

and a column count into a matrix containing those columns, or 
transforms a sequence of numbers and an element count into a vector 
with those numbers as elements. 


Level n +1 ... 

Level 2 

Level 1 

4 Level 1 

[ vector ] columnl 

[ vector ] columnn 

"columncount 

■+ [[ matrix ]] 

e(ement x 

element n 

"elem en tcou n t 

-+ [ vector ] 


Keyboard Access: 



Affected by Flags: None 

Remarks: All vectors must have the same length. The column or 
element count is rounded to the nearest integer. 


Related Commands: ^COL, ->ROW, ROW 


COLCT 

Collect Like Terms Command: Simplifies an algebraic expression or 

equation by “collecting” like terms. 



{} 


Keyboard Access: 


SYMBOLIC I 


Affected by Flags: None 
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COLE 


Remarks: COLCT operates separately on the two sides of an 
equation, so that like terms on opposite sides of the equation are not 

combined. 


Examples: ' 6+EXP<18V COLCT returns 8.71828182846 
1 5+X+9 ' COLCT returns 1 14+X 1 . 

1 X*i_m+X*9_cn 1 COLCT returns 1 (109_cwi>*X 1 . 

' X A Z*Y*X A T*Y 1 COLCT returns 1 X A CT+Z>*Y A £ ’ . 


1 X+3*X+Y+Y ' COLCT returns 1 4*X+2*Y'. 

Related Commands: EXPAN, ISOL, QUAD, SHOW 


COLE 

Sigma Columns Command: Specifies the independent-variable and 

dependent-variable columns of the current statistics matrix (the 
reserved variable EDAT ). 


{} 


Level 2 

Level 1 

- Level 1 


x xcol 

x ycol 

- 

i: 


Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: COLS combines the functionality of XCOL and YCOL. It 
is included in the HP 48 for compatibility with the HP 28S. 

The independent-variable column number x xcol is stored as the first 
parameter in the reserved variable EPAR (the default is 1). The 
dependent-variable column number x yco[ is stored as the second 
parameter in EPAR (the default is 2). 

COLE accepts and stores noninteger real numbers, but subsequent 
commands that use these two parameters in EPAR will cause errors. 
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COLE 


Example: 2 5 COLS sets column 2 in UDAT as the independent- 
variable column, sets column 5 as the dependent-variable column, and 
stores 2 and 5 as the first and second elements in SPAR. 

Related Commands: BARPLOT, BESTFIT, CORR, COV, 
EXPFIT, HISTPLOT, UNFIT, LOGFIT, LR, PREDX, PREDY, 
PWRFIT, SCATRPLOT, XCOL, YCOL 


COMB 

Combinations Function: Returns the number of possible 
combinations of n items taken m at a time. 


Level 2 


Level 1 


Level 1 


{} 


1 symbn 1 


'symbn ' 


m 


m 


1 symbm 

' symb m 


Cn; m 

'COMB(sy/??/?n , m) * 
'COMB(/7, symb m )' 
'COMB(symi? n , symb m )' 


Keyboard Access: ImthI [nxt! IMIS! 
# .. . . 


in 


Affected by Flags: Numerical Results (—3) 

Remarks: The following formula is used to calculate C n , 


C 


nl 


n.m 


rn\(n — rn) 


The arguments n and m must each be less than 10 


12 


Related Commands: PERM, ! 
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CON 

Constant Array Command: Returns a constant array, defined as an 
array whose elements all have the same value. 


Level 2 Level 1 -► Level 1 


{ n 


colum ns 



{ n rows 0 1 u m ns } 

[ R-array ] 

[ C-array ] 

1 name 1 


^constant 

7 

^-constant 
*co n sta n t 
z consta nt 
z consta nt 


[ vector constant ] 
[[ matr/x constant ]] 
[ R-array consta nt ] 
[ C-a/ray constgnt ] 


Keyboard Access: 






Affected by Flags: None 

Remarks: The constant value is a real or complex number taken 
from level 1. The resulting array is either a new array, or an existing 
array with its elements replaced by the constant, depending on the 
object in level 2. 


■ Creating a new array: If level 2 contains a list of one or two 
integers, CON returns a new array. If the list contains a single 
integer ^columns* CON returns a constant vector with n elements. 

If the list contains two integers n TOWS and m columns , CON returns a 
constant matrix with n rows and rn columns. 


■ Replacing the elements of an existing array: If level 2 contains an 
array, CON returns an array of the same dimensions, with each 
element equal to the constant. If the constant is a complex number, 
the original array must also be complex. 

If level 2 contains a name, the name must identify a variable that 
contains an array. In this case, the elements of the array are 
replaced by the constant. If the constant is a complex number, the 
original array must also be complex. 


Examples: 


j * * i 


[ <2,4} <7,9> ] 3 
[ <3,0} <3,0> ]. 


6 COH returns the matrix C [ 6 6 ] [ 6 6 ] ]. 
CON returns the complex vector 
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CON 

Related Commands: IDN 


COND 


Condition Number Command: Returns the 1-norm (column norm) 

condition number of a square matrix. 



{> 

Level 1 

- 

Level 1 

[[ matrix ]] n x r, 

- 

*co n d itio nnumber 


Keyboard Access: [mth! IHIHI 




Affected by Flags: None 

Remarks: The condition number of a matrix is the product of the 
norm of the matrix and the norm of the inverse of the matrix. CONI) 
uses the 1-norm and computes the condition number of the matrix 
without computing the inverse of the matrix. 


The condition number expresses the sensitivity of the problem of 
solving a system of linear equations having coefficients represented by 
the elements of the matrix (this includes inverting the matrix). That 
is, it indicates how much an error in the inputs may be magnified in 
the outputs of calculations using the matrix. 

In many linear algebra computations, the base 10 logarithm of the 
condition number of the matrix is an estimate of the number of digits 
of precision that might be lost in computations using that matrix. A 
reasonable rule of thumb is that the number of digits of accuracy in 
the result is approximately MIN(12,15~log 10 (COND)). 

Example: The following program computes the above rule of thumb 
for the number of accurate digits: 


DUP SIZE 1 GET LOG SNAP COND LOG + II SWAP 
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Related Commands: SNRM, SRAD, TRACE 


CONIC 

Conic Plot Type Command: Sets the plot type to CONIC. 


Keyboard Access: 


f^lfPLOTl 




Affected by Flags: None 


Remarks: When the plot type is CONIC, the DRAW command 
plots the current equation as a second-order polynomial of two real 
variables. The current equation is specified in the reserved variable 
EQ. The plotting parameters are specified in the reserved variable 
PPAR , which has this form: 



3-kiiL ? $min ^max ? 


?/max- :! tndep res axes piype depend > 


For plot type CONIC, the elements of PPAR are used as follows: 


■ £m i n 3 Vm\n is a complex number specifying the lower left corner 

of PICT (the lower left corner of the display range). The default 
value is < -6 „ 5 ? -3■ 1 >. 


■ ax ? ax is a complex number specifying the upper right 
corner of PICT (the upper right corner of the display range). The 
default value is < 6 - 5 ? 3. 2 ). 

■ indep is a name specifying the independent variable, or a list 
containing such a name and two numbers specifying the minimum 
and maximum values for the independent variable (the plotting 
range). The default value is X , 

■ res is a real number specifying the interval (in user-unit 
coordinates) between plotted values of the independent variable, or 
a binary integer specifying the interval in pixels. The default value 
is 8 , which specifies an interval of 1 pixel. 

■ axes is a complex number specifying the user-unit coordinates of the 
intersection of the horizontal and vertical axes, or a list containing 
such a number and two strings specifying labels for the horizontal 
and vertical axes. The default value is < 0 , £ 0 . 
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■ ptype is a command name specifying the plot type. Executing the 
command CONIC places the command name CONIC in PPAR. 

u depend is a name specifying the dependent variable. The default 
value is Y. 

The current equation is used to define a pair of functions of 
the independent variable. These functions are derived from the 
second-order Taylor’s approximation to the current equation. The 
minimum and maximum values of the independent variable (the 
plotting range) can be specified in indtp ; otherwise, the values in 

Vmin and ^maxj 2/max) (the display range) are used. Lines 
are drawn between plotted points unless flag —31 is set. 

Related Commands: BAR, DIFFEQ, FUNCTION, GRIDMAP, 
HISTOGRAM, PARAMETRIC, PARSURFACE, PCONTOUR, 
POLAR, SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, 
YSUCE 


CONJ 

Conjugate Analytic Function: Conjugates a complex number or a 

complex array. 


Level 1 

■+ Level 1 

X 

X 

(x, y) 

■+ (x, -y) 

[ R-array] 

■+ [ R-array ] 

[ C-array ] 2 

■+ [ C-array ] 2 

'symd' 

■+ 1 CONJ (symb ) 1 


Keyboard Access: (mth) (nxt 





Affected by Flags: Numerical Results (—3) 
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CONST 


Remarks: Conjugation is the negation (sign reversal) of the 
imaginary part of a complex number. For real numbers and real 
arrays, the conjugate is identical to the original argument. 


Example: 



CONJ returns 



A square matrix A containing complex elements is said to be 
Hermitian if A H — A, where A H is the same as a normal transpose 
except that the complex conjugate of each element is used. The 
following program returns 1 if the input matrix is Hermitian, and a 0 
if it is not. 


DUP TRN CONJ SAME 


Related Commands: ABS, IM, RE, SCONJ, SIGN 


CONLIB 


Open Constants Library Command: Opens the Constants Library 

catalog. 


Keyboard Access: 
Affected by Flags: 
Related Commands: 


[♦tKeq lib) §1111 


None 

CONST 


------ • • - • ■» • ' • • 


CONST 

Constant Value Command: Returns the value of a constant. 



Level 1 -» 

Level 1 

'name 1 —► 

X 


Keyboard Access: (^jf eq lib ) wmmm 

a- 

II.. -- - --iJiimi.iipiiftn 1 I I > I- ! !!!■!■ 

■ . _ _ _ _ b. b ■ ■■■) i ■ b ■ ■ ■ a ■ i ■ ■ 


Affected by Flags: 


Units Type (60), Units Usage (61) 
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CONST 


Remarks: CONST returns the value of the specified constant. It 
chooses the unit type depending on flag 60 (SI if clear, English if set), 
and uses the units depending on flag 61 (uses units if clear, no units if 
set). 

See “Using the Constants Library” in chapter 25 of the HP 48 User's 
Guide for a list of the constants available in the HP 48’s Constants 
Library. 

Related Commands: CONLIB 


CONT 

Continue Program Execution Command: Resumes execution of a 

halted program. 

Keyboard Access: f^nfcoNTl 
Affected by Flags: None 

Remarks: Since CONT is a command, it can be assigned to a key or 
to a custom menu. 

Example: The program 


k * 


A. 


n 


* * 


Enter fl? pres 


CONT 


II 


CONT 


MENU PROMPT 


displays a prompt message, builds a menu with the CONT command 
assigned to the first menu key, and halts the program for data input. 
After entering data, pressing f iSlBRl resumes program execution. 
(Note that pressing f^r)[CONT) is equivalent to pressing ||(C:||if®|.) 


Related Commands: HALT, KILL, PROMPT 
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CORR 


CONVERT 

» 

Convert Units Command: Converts a source unit object to the 
dimensions of a target unit. 


{} 


Level 2 

Level 1 -*■ 

Level 1 


_U/?/tSsou rce 

x 2 _un/ts target -* 

x 3 _ units t a rg e t 




Keyboard Access: (units) *K0M 

Affected by Flags: 

Remarks: The source and target units must be compatible. The 
number part x 2 of the target unit object is ignored. 

Related Commands: UBASE, UFACT, ->UNIT, UVAL 


CORR 

Correlation Command: Returns the correlation coefficient of the 

independent and dependent data columns in the current statistics 
matrix (reserved variable EDAT). 


Level 1 


Level 1 


correlation 


Keyboard Access: 


(♦tKstaTI MB 


■ ■ i - 



Affected by Flags: None 


Remarks: The columns are specified by the first two elements in the 
reserved variable EPAR , set by XCOL and YCOL, respectively. If 
EPAR does not exist, CORR creates it and sets the elements to their 
default values (1 and 2). 
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CORR 


The correlation is computed with the following formula: 



4 


where X{ ni is the iih coordinate value in column ii 1 , Xi n2 is the ?th 
coordinate value in the column n 2 , x ni is the mean of the data in 
column n 1 , x n2 is the mean of the data in column n 2 , and n is the 
number of data points. 


Related Commands: COLE, COV, PREDX, PREDY, XCOL, 
YCOL 


cos 

Cosine Analytic Function: Returns the cosine of the argument. 


{} 


Level 1 


Level 1 


cos z 


'symb 1 


x^unit 


angular 


'COS (symb)' 
cos (x_un/t anquIar ) 


Keyboard Access: fees! 

Affected by Flags: Numerical Results (—3), Angle Mode (—17, —18) 

Remarks: For real arguments, the current angle mode determines 
the number’s interpretation as an angle, unless the angular units are 
specified. 

For complex arguments, cos(x + iy) — cosx cosh# — i sinx sinh y. 

If the argument for COS is a unit object, then the specified angular 
unit overrides the angle mode to determine the result. Integration and 
differentiation, on the other hand, always observe the angle mode. 
Therefore, to correctly integrate or differentiate expressions containing 
COS with a unit object, the angle mode must be set to Radians (since 
this is a “neutral” mode). 
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Related Commands: ACOS, SIN, TAN 



COSH 

Hyperbolic Cosine Analytic Function: Returns the hyperbolic cosine 

of the argument. 



Level 1 


Level 1 


z 

'symb' 


cosh z 

'COSH (symb)' 


Keyboard Access: (mthj llljll 



Affected by Flags: Numerical Results (—3) 


Remarks: For complex arguments, cosh(x + iy) = coshx cosy + i 
sinhrr siny. 


Related Commands: ACOSH, SINH, TANH 


cov 

Covariance Command: Returns the sample covariance of the 

independent and dependent data columns in the current statistics 
matrix (reserved variable £ DAT). 


Level 1 


Level 1 


cova nance 


Keyboard Access: f stat 1 IBB 











































cov 


Affected by Flags: None 

Remarks: The columns are specified by the first two elements in 
reserved variable SPAR, set by XCOL and YCOL respectively. If 
EPAR does not exist, COV creates it and sets the elements to their 
default values (1 and 2). 

The covariance is calculated with the following formula: 


1 


n 


n 


1 




2 = 1 


where Xi mi is the ith coordinate value in column n 1 , Xi n2 is the ith 
coordinate value in the column n 7 , x ni is the mean of the data in 
column n 1 , x n2 is the mean of the data in column n 2 , and n is the 
number of data points. 

Related Commands: COLE, CORR, PCOV, PREDX, PREDY, 
XCOL, YCOL 



Carriage Right Command: Prints the contents, if any, of the printer 

buffer. 


Keyboard Access: QQ/ o} iBill llll 

Affected by Flags: Double-Spaced Printing (—37), Printing Device 
(-34), I/O Device (-33) 


If flag —34 is set (printer output directed to the serial port), flag —33 
must be clear. 


Remarks: When using the HP 82240B Infrared Printer (flag —34 
clear), CR leaves the printhead on the right end of the just printed 
line. 


When printing to the serial port (flag —34 set), CR sends to the 
printer a string that encodes the line termination method. The default 
termination method is carriage-return/linefeed. The string is the 
fourth parameter in the reserved variable PRTPAR. 

Related Commands: DELAY, OLDPRT, PRLCD, PRST, PRSTC, 
PRVAR, PR1 
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CROSS 


CRDIR 

Create Directory Command: Creates an empty subdirectory with 

the specified name within the current directory. 


_ {} 

Level 1 > Level 1 


'global' 


Keyboard Access: (♦tKmemory) 8HIIH Sillli 

* . T . . . . . 

Affected by Flags: None 

Remarks: CRDIR does not change the current directory; evaluate 
the name of the new subdirectory to make it the current directory. 

Related Commands: HOME, PATH, PGDIR, UPDIR 


CROSS 

Cross Product Command: CROSS returns the cross product 
C = A x B of vectors A and B. 


{} 


Level 2 

Level 1 

+ Level 1 

[ vector ] A 

[ vector ] e 

+ t vector ] A x B 


Keyboard Access: (mth) 


n 


vt HR* 





Affected by Flags: None 

Remarks: The arguments must be vectors having two or three 
elements, and do not both need the same number of elements. (The 
HP 48 automatically converts a two-element argument C d 1 d 2 1 to a 
three-element argument C d 1 d 2 0 3.) 
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CROSS 

Related Commands: CNRM, DET. DOT, RNRM 


CSWP 

Column Swap Command: Swaps columns i and j of the argument 
matrix and returns the modified matrix, or swaps elements f and j of 
the argument vector and returns the modified vector. 


{} 


Level 3 

Level 2 

Level 1 

- Level 1 

[[ matrix 

“c o1u m ni 

"columnj 

-+ [[ matrix ]] 2 

[ vector ] x 

^elem enti 

"element] 

-+ [ vector ] 2 


mm 

Ifcpfc!‘ 



Keyboard Access: [MTiTl liS 
Affected by Flags: None 

Remarks: Column numbers are rounded to the nearest integer. 
Vector arguments are treated as row vectors. 

Related Commands: COL+, COL-, RSWP 


CYLIN 


Cylindrical Mode Command: Sets Cylindrical coordinate mode. 

Keyboard Access: 


Qf MODES 1 lUilll Hill 


MTffli iwn iimis 


Affected by Flags: None 

Remarks: CYLIN clears flag —15 and sets flag —16, and displays the 
R<£Z annunciator. 
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In Cylindrical mode, vectors are displayed as polar components. 
Therefore, a 3D vector would appear as [R A .9 Z], 

Related Commands: RECT, SPHERE 


C^PX 

Complex to Pixel Command: Converts the specified user-unit 
coordinates to pixel coordinates. 

{} 

Level 1 -> Level 1 

(X, y) -» { #n #m } 


Keyboard Access: (prgi — (nxti 



Affected by Flags: None 


Remarks: The user-unit coordinates are derived from the 


( x min> 3/m in) an d (imax; j/max) parameters in the reserved variable 

P PA R. 


Related Commands: PX->C 


C- 

+R 




Complex to Real Command: Separates the real and imaginary parts 
of a complex number or complex array. 







Level 1 -+ 

Level 2 

Level 1 



(x, y) — 

X 

y 



[ C-array] —► 

[ R-array ] x 

[ R-array ] 2 
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C—>R 


Keyboard Access: 


“ b ■ ■ IJJJ » <• M > *' «,.■ » ! >.J ■ h % b a i ■» * - »u ■ fc |' ■ ■*'« r rrn ran. ■>_ - ■ ? f M i 

fMTH) fNXTl 18il s ®|I il!l®@ 


ill'll ‘ ■ ■ «< li b e n n r r 1 - r - - - -■■■■■■ ■■■■■!. 

fPRGl lliHBI f NXTl 


■ ■■■■- ani -■■■■■■■I iHI i h m i ! 'H 


■ a I ■ 1 I S 4 l!ri !■ 


Affected by Flags: None 


Remarks: The result in level 2 represents the real part of the 
complex argument. The result in level 1 represents the imaginary part 
of the complex argument. 


Related Commands: R^C, RE, IM 


DARCY 

Darcy Friction Factor Function: Calculates the Darcy friction factor 

of certain fluid flows. 


{} 


Level 2 

Level 1 

— Level 1 

%e/D 

•^Re 

“ *' x Darcy 

Keyboard Access: 

RtHeq LIB)?! 

■IB# O R R C V 

Affected by Flags: 

None 



Remarks: DARCY calculates the Fanning friction factor and 
multiplies it by 4. x e /o is the relative roughness—the ratio of the 
conduit roughness to its diameter. y^ c is the Reynolds number. 

The function uses different computation routines for laminar flow 
(Re < 2100) and turbulent flow (Re > 2100). x e /D and y^ e must be 
real numbers or unit objects that reduce to dimensionless numbers, 
and both numbers must be greater than 0. 

Related Commands: FANNING 
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DATE 


DATE 

Date Command: Returns the system date to level 1. 


Level 1 


date 


Level 1 


Keyboard Access: (^tKtime! HlUB 


Affected by Flags: Date Format (—42) 


Example: If the current date is May 12, 1990, if flag —42 is clear, 
and if the display mode is Standard, DhTE returns 5* 12199. (The 
trailing zeros are dropped.) 


Related Commands: DATE+, DDAYS, TIME, TSTR 


DATE 


Set Date Command: Sets the system date to date . 


{} 

Level 1 Level 1 


date 


Keyboard Access: 



Affected by Flags: Date Format (—42) 

Remarks: date has the form MM.DDYYYY or DD.MMYYYY , 
depending on the state of flag —42. MM is month, DD is day, and 
YYYY is year. If YYYY is not supplied, the current specification for 
the year is used. The range of allowable dates is January 1, 1991 to 
December 31, 2090. 
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DATE 


Example: If flag —42 is set and the current system year is 1995, then 
£8-97 *DFlTE sets the system date as July 28, 1995. 

Related Commands: -^TIME 


DATE+ 



Date Addition Command: Returns a past or 

date in level 2 and a number of days in level 1 

future date, given a 

* 



o 

Level 2 

Level 1 -*■ 

Level 1 

date l 

y _ y 

days 

datGft ew 


Keyboard Access: QQTMjT) (nxt) fipBli 

Affected by Flags: Date Format (—42) 


Remarks: If £ days is negative, DATE+ calculates a past date. The 
range of allowable dates is October 15, 1582, to December 31, 9999. 


Related Commands: DATE, DDAYS 


DBUG 

Debug Operation: Starts program execution, then suspends it as if 
HALT were the first program command. 


Level 1 


Level 1 


<C program > or 'program name' 


Keyboard Access: 


(PRG)(NXT) 



a-- i it -t * 
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Affected by Flags: None 
Remarks: DBUG is not programmable. 

Related Commands: HALT, NEXT, SST, SST| 


DEC 


DDAYS 

Delta Days Command: Returns the number of days between two 
dates. 


{} 


Level 2 

Level 1 

- 

Level 1 

date x 

date 7 

- 

x 6 ays 


Keyboard Access: 


r^fTiMEl fNXTl 111 




Affected by Flags: Date Format (—42) 


Remarks: If the level 2 date is chronologically later than the level 1 
date, the result is negative. The range of allowable dates is October 

15, 1582, to December 31, 9999. 


Related Commands: DATE, DATE+ 


DEC 


Decimal Mode Command: Selects decimal base for binary integer 
operations. (The default base is decimal.) 


Keyboard Access: 





Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 

Remarks: Binary integers require the prefix #. Binary integers 
entered and returned in decimal base automatically show the suffix 
d. If the current base is not decimal, then you can enter a decimal 
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DEC 


number by ending it with d. It will be displayed in the current base 
when it is entered. 

The current base does not affect the internal representation of binary 
integers as unsigned binary numbers. 

Related Commands: BIN, HEX, OCT, RCWS, STWS 


DECR 

Decrement Command: Takes a variable on level 1, subtracts 1, 

stores the new value back into the original variable, and returns the 
new value to level 1. 


{} 


Level 1 

-» Level 1 

‘name 1 



Keyboard Access: i^kmemory 

1 R-fMiii: iftfelite 

; iiri ■■■■■■ riririikrriai i,r_. 1 ji i n <i i - ii i.i 1 1 1 1 • • 1 ■ ■ ■ i ■ ■ p - ■ ■ ■ I I I ■ 


Affected by Flags: None 


Remarks: The contents of name must be a real number. 


Example: If 35 „ 7 is stored in A, 1 Fi 1 DECR returns 34 


* I 


The following program counts down from 100 to 0 and leaves the 

integers 100 to 0 on the stack: 


108 1 Fl' ST0 

WHILE R REFER! l f\ l DECR END 
' R 1 FURGE 

Related Commands: INCH 
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DEFINE 

Define Variable or Function Command: Stores the expression on the 

right side of the = in the variable specified on the left side, or creates a 
user-defined function. 


{} 

Level 1 

Level 1 

1 name=exp' 

' name{name l ... name ri )=exp(name l ... name n ) 1 



Keyboard Access: Q(DfF) 

Affected by Flags: Numerical Results (—3) 

For arguments of the form 1 name-exp 1 , if flag —3 is set, expression 
will be evaluated to a number before it is stored in name , (If exp 
contains a formal variable, DEFINE will error if flag —3 is set.) 

Remarks: If the left side of the equation is name only, DEFINE 
stores exp in the variable name. 

If the left side of the equation is name followed by parenthetical 
arguments name 1 ... name n , DEFINE creates a user-defined 
function and stores it in the variable name. 


Examples: 1 fl 


jii V i 
* r i 


DEFI HE stores 



in variable A. 


I 


fKX 3 Y>=2*X+3--‘*Y * DEFINE creates a user-defined function A. The 


contents of A is the program •£ 


X Y 


,B, | ».< I I r ■***! ■ I, 


I 


Related Commands: STO 
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DEG 

Degrees Command: Sets Degrees angle mode. 


Keyboard Access: [»D(modes1 
Affected by Flags: None 



i i i ■ i i i i i . - - i i 

.. Msob- 


Remarks: DEG clears flags — 17 and —18, and clears the RAD and 
GRAD annunciators. 


In Degrees angle mode, real-number arguments that represent angles 
are interpreted as degrees, and real-number results that represent 
angles are expressed in degrees. 

Related Commands: GRAD, RAD 


DELALARM 

Delete Alarm Command: Deletes the alarm specified in level 1. 


_ {} 

Level 1 — Level 1 


"index 


Keyboard Access: 


SHIM) 



Affected by Flags: None 


Remarks: If ni n d ex is 0, all alarms in the system alarm list are 
deleted. 

Related Commands: FINDALARM, RCLALARM, STOALARM 
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DELAY 


DELAY 

Delay Command: Specifies how many seconds the HP 48 waits 
between sending lines of information to the printer. 



Level 1 


*d e l a y 


Level 1 



Keyboard Access: 


Affected by Flags: Printing Device ( 



■ -f-.- ■- a ■ ■■■ i%' p ^ 1 t 

■IBB""*-------«■* I ■ • ! ' = - ■ ■ i I M ■ ■ 11-111 --■*- * - j ■ ■ 

eH -. I I i I I I ill i i mHin i 111--*11^4 

) and I/O Device ( 



33) 


Setting flag —34 directs printer output to the serial port. In this case, 
flag —33 must be clear. 


If flag —34 is set and transmit pacing is enabled (nonzero) in reserved 
variable IOPAR , then XON/XOFF handshaking controls data 
transmission and the delay setting has no effect. 

Remarks: £ dejay specifies the delay time in seconds. The default 
delay is 1.8 seconds. The maximum delay is 6.9 seconds. (The sign of 
x deiay is ignored, so -4 DELAY is equivalent to 4 DELAY.) 

The delay setting is the first parameter in the reserved variable 

PRTPAR. 


A shorter delay setting can be useful when the HP 48 sends multiple 
lines of information to your printer (for example, when printing a 
program). To optimize printing efficiency, set the delay just longer 
than the time the printhead requires to print one line of information. 

If you set the delay shorter than the time to print one line, you may 
lose information. Also, as the batteries in the printer lose their charge, 
the printhead slows down. and. if you have previously decreased 
the delay, you may have to increase it to avoid losing information. 
(Battery discharge will not cause the printhead to slow to more than 
the 1.8-second default delay setting.) 

Related Commands: CR, OLDPRT, PRLCD, PRST, PRSTC, 
PRVAR, PR1 
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DELKEYS 

Delete Key Assignments Command: Clears user-defined key 

assignments. 


Level 1 


Level 1 


"key 

{ x keyl ••' *keyn ) 


I /N I 


Keyboard Access: 



Affected by Flags: User-Mode Lock (—61) and User Mode (—62) 

affect the status of the user keyboard* 


Remarks: The argument a; Key is a real number rc.p specifying the 
key by its row number, its column number, and its plane (shift). For 
a definition of plane, see ASN. 


Specifying 0 for £ key clears all user key assignments and restores the 
standard key assignments. 


Specifying S as the argument for DELKEYS suppresses all standard 
key assignments on the user keyboard. This makes keys without 
user key assignments inactive on the user keyboard. (You can make 
exceptions using ASN, or restore them all using STOKEYS.) If you 

are stuck in User mode—probably with a “locked 55 keyboard—because 
you have reassigned or suppressed the keys necessary to cancel User 
mode, do a system halt (“warm start 55 ): press and hold (ON ) and the 
C key simultaneously, releasing the C key first. This cancels User 
mode. 


Deleted user key assignments still take up from 2.5 to 15 bytes of 
memory each. You can free this memory by packing your user key 


assignments by executing RCLKEYS 


8 DELKEYS 


STOKE Y 



Related Commands: ASN, RCLKEYS, STOKEYS 
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DEPND 


DEPND 

Dependent Variable Command: Specifies the dependent variable 
(and its plotting range for TRUTH plots). 


Level 2 

Level 1 

-> Level 1 


' global 1 

- 


{ global } 



{ global y start y end } 

- 


{ ^start nd J 

- 

■^sta rt 

^en d 

■ — —v 


Keyboard Access: ® (plot) lllil 



Affected by Flags: None 


Remarks: The specification for the dependent variable name and its 

plotting range is stored in the reserved variable PPAR as follows: 

■ If the argument is a global variable name, that name replaces the 
dependent variable entry in PPAR. 

■ If the argument is a list containing a global name, that name 
replaces the dependent variable name but leaves unchanged any 
existing plotting range. 

■ If the argument is a list containing a global name and two real 
numbers, or a list containing a name, array, and real number, that 
list replaces the dependent variable entry. 

■ If the argument is a list containing two real numbers, or two real 
numbers from levels 1 and 2, those two numbers specify a new 
plotting range, leaving the dependent variable name unchanged. 
(LASTARG returns a list, even if the two numbers were entered 
separately.) 

The default entry is Y . 

The plotting range for the dependent variable is meaningful only for 

plot type TRUTH, where it restricts the region for which the equation 
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DEPND 


is tested, and for plot type DIFFEQ, where it specifies the initial 
solution value and absolute error tolerance. 

Related Commands: INDEP 


DEPTH 

Depth Commend: Returns a real number representing the number of 
objects present on the stack (before DEPTH was executed). 


Level 1 


Level 1 




Keyboard Access: l+TH stack 1 11111 


Affected by Flags: None 


DET 

Determinant function: Returns the determinant of a square matrix. 


{} 


Level 1 

Level 1 

[[ matrix ]] 

* ^determinant 


tveyooara Access: [ mth j : 

aniu wm i imxt i mmmm 


Affected by Flags: Tiny Element (—54) 

Remarks: The argument matrix must be square. DET computes 
the determinant of 1 x 1 and 2x2 matrices directly from the defining 
expression for the determinant. DET computes the determinant of 
a larger matrix by computing the Crout LU decomposition of the 
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DET 

matrix and accumulating the product of the decomposition’s diagonal 
elements. 

Since floating-point division is used to do this, the computed 
determinant of an integer matrix is often not an integer, even though 
the actual determinant of an integer matrix must be an integer. 

DET corrects this by rounding the computed determinant to an 
integer value. This technique is also used for noninteger matrices with 
determinants having fewer than 15 nonzero digits: the computed 
determinant is rounded at the appropriate digit position to restore 
some or all of the accuracy lost to floating-point arithmetic. 

This refinement technique can cause the computed determinant to 
exhibit discontinuity. To avoid this, you can disable the refinement by 
setting flag —54. 

Example: For a square matrix T, the minor of element a V} is the 
determinant of the submatrix that remains after deleting row i and 
column j from the original matrix. Given a square matrix in level 3, i 
in level 2, and j in level 1. the following program, MINOR determines 
the minor of the submatrix: 




+ M row col 

M row ROW- DROP col COL- 



DROP DET 


For example, entering [ C 1 2 3 3 [ 4 5 6 1C 7 8 9 11 2 3 MINOR 
returns -6. 

Related Commands: CNRM, CROSS, DOT, RNRM 


V 
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DETACH 

Detach Library Command: Detaches the library with the specified 
number from the current directory. Each library has a unique number. 
If a port number is specified, it is ignored. 


{} 

Level 1 Level 1 

"library 

* n _ i. 

•"port ‘"library 


Keyboard Access: 



Affected by Flags: None 


Remarks: A RAM-based library object attached to the HOME 
directory must be detached before it can be purged, whereas a library 
attached to any other directory does not. Also, a library object 
attached to a non-HOME directory is automatically detached (without 
using DETACH) whenever a new library object is attached there. 

Related Commands: ATTACH. LIBS, PURGE 


DIAG-> 

Array to Matrix Diagonal Command: Takes an array and a specified 

dimension and returns a matrix whose maj or diagonal elements are 
the elements of the array. 


Level 2 

Level 1 

■+ Level 1 

[ array ] diagonals 

{ dim } 

■* [[ matrix ]] 


Keyboard Access: (mth) wMKm fNxr] 1111 

v .. 


Affected by Flags: None 
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Remarks: Real number dimensions are rounded to integers. If 
a single dimension is given, a square matrix is returned. If two 
dimensions are given, the proper order is { number of rows, number of 
columns }. No more than two dimensions can be specified. 

If the main diagonal of the resulting matrix has more elements than 
the array, additional diagonal elements are set to zero. If the main 
diagonal of the resulting matrix has fewer elements than the array, 
extra array elements are dropped. 

Related Commands: -^DIAG 


->DIAG 

Matrix Diagonal to Array Command: Returns a vector that contains 

the major diagonal elements of a matrix. 


{} 



Level 1 

- 

Level 1 


[[ matrix ]] 

- 

[ vector] diagona|s 


Keyboard Access: imthi mm 


■ ■> ■ 




Affected by Flags: None 


Remarks: The input matrix does not have to be square. 

Related Commands: DIAG—* 
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DIFFEQ 


Differential Equation Plot Type Command: Sets the plot type to 
DIFFEQ. 


Keyboard Access: (♦tI(plot) 1J 


II- — r - h ■ 


Affected by Flags: None 


Remarks: When the plot type is DIFFEQ and the reserved variable 
EQ does not contain a list, the initial value problem is solved and 
plotted over an interval using the Runge-Kutta-Fehlberg (4,5) method. 
The plotting parameters are specified in the reserved variable PPAR } 
which has the following form: 



%iit ? 2/min 




indep res axes ptype depend > 


For plot type DIFFEQ, the elements of PPAR are used as follows: 


■ x m j n , ?/ m j n ) is a complex number specifying the lower left corner 
of PICT (the lower left corner of the display range). The default 
value is < -6 „ 5 ? -3« 1 >. 


■ ‘Tmaxi Umax) is a complex number specifying the upper right 
corner of PICT (the upper right corner of the display range). The 
default value is <6.5? 3.2), 


■ indep is a list, t 1 X 1 xq Xf J, containing a name that specifies the 
independent variable, and two numbers that specify the initial and 
final values for the independent variable. The default values for 
these elements are -L 1 X 1 8 x m a x >. 

■ res is a real number specifying the maximum interval, in user-unit 
coordinates, between values of the independent variable. The 
default value is 8. If res does not equal zero, then the maximum 
interval is res. If res equals zero, the maximum interval is 
unlimited. 


■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin, a list specifying the tick-mark annotation, and two 
strings specifying labels for the horizontal and vertical axes. If the 
solution is real-valued, these strings can specify the dependent or 
the independent variable; if the solution is vector valued, the strings 
can specify a solution component: 

□ "0" specifies the independent variable (X) 
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□ "l" specifies the dependent variable ( Y ) 

□ 11 n " specifies a solution component Y n 

If axes contains any strings other than "0"j "l", or "n", the 
DIFFEQ-plotter uses the default strings n 0 n and “l", and plots 
the independent variable on the horizontal axis and the dependent 
variable on the vertical. 

■ Ptype is a command name specifying the plot type. Executing the 
command DIFFEQ places the command name DIFFEQ in PPAR , 

■ depend is a list, C 1 Y 1 yo xjsrrToi -h containing a name that 
specifies the dependent variable (the solution), and two numbers 
that specify the inital value of Y and the global absolute error 
tolerance in the solution Y. The default values for these elements 
are € 1 Y' 0 .0001 >. 

EQ must define the right-hand side of the initial value problem 
Y 1 (X)—F(X,Y). Y can return a real value or real vector when 
evaluated. 

The DIFFEQ-plotter attempts to make the interval between values 
of the independent variable as large as possible, while keeping the 
computed solution within the specified error tolerance XErrTob This 
tolerance may hold only at the computed points. Straight lines are 
drawn between computed step endpoints, and these lines may not 
accurately represent the actual shape of the solution, res limits the 
maximum interval size to provide higher plot resolution. 

On exit from DIFFEQ plot, the first elements of indep and depnd 
(identifiers) contain the final values of X and Y , respectively. 

If EQ contains a list, the inital value problem is solved and plotted 
using a combination of Rosenbrock (3,4) and Runge-Kutta-Fehlberg 
(4,5) methods. In this case DIFFEQ uses RRKSTEP to calculate y /, 

and EQ must contain two additional elements: 

■ The second element of EQ must evaluate to the partial derivative 
of Y 1 with respect to X , and can return a real value or real vector 
when evaluated. 

■ The third element of EQ must evaluate to the partial derivative of 
Y ' with respect to Y, and can return a real value or a real matrix 
when evaluated. 
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DIFFEQ 

Related Commands: AXES, CONIC, FUNCTION, PAR AMETRIC, 
POLAR, RKFSTEP, RRKSTEP, TRUTH 


DISP 

Display Command: 

Displays obj in the nth display line. 

{} 

Level 2 

Level 1 -> Level 1 


obj 

n —► 


Keyboard Access: 

(PRGl (nxT) iiiiill iiliifc 


Affected by Flags: 

None 



Remarks: n < 1 indicates the top line of the display; n > 7 indicates 
the bottom line. 


To facilitate the display of messages, strings are displayed without 
the surrounding 11 11 delimiters. All other objects are displayed in 
the same form as would be used if the object were in level 1 in the 
multiline display format. If the object display requires more than 
one display line, the display starts in line n, and continues down the 
display either to the end of the object or the bottom of the display. 

The object displayed by DISP persists in the display only until the 
keyboard is ready for input. The FREEZE command can be used to 
cause the object to persist in the display until a key is pressed. 


Example: The program 


u 


ENTER Data Now" 1 DISP 


FREEZE HRLT :** 


displays ENTER Data How at the top of the 
entire display, and halts. 



a 


freezes” the 


Related Commands: FREEZE, HALT, INPUT, PROMPT 
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DO 

DO Indefinite Loop Structure Command: 

END indefinite loop structure. 

Starts DO ... UNTIL ... 

Level 1 -+ 

Level 1 

DO 

UNTIL — 

END T/F 



Keyboard Access: [prgJ IpHIS 




Affected by Flags: None 


Remarks: DO ... UNTIL ... END executes a loop repeatedly until 
a test returns a true (nonzero) result. Since the test clause is executed 
after the loop clause, the loop is always executed at least once. The 
syntax is: 


DO loop-clause UNTIL test-clause END 

DO starts execution of the loop clause. UNTIL ends the loop clause 
and begins the test clause. The test clause must return a test result to 
the stack. END removes the test result from the stack. If its value is 
zero, the loop clause is executed again; otherwise, execution resumes 
following END. 

Example: The following program counts down from 100 to 0 and 
leaves the integers 100 to 0 on the stack: 




100 'FT STD fi 
DO 'O' DECR 
UNTIL 1 R==0 
END 

' fl 1 PURGE 
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DO 

Related Commands: END, UNTIL, WHILE 


DOERR 

DO Error Command: Executes a “user-specified” error, causing a 

program to behave exactly as if a normal error had occurred during 
program execution. 


{} 


Level 1 


Level 1 


fte rror 


#«er 


ror 


"error” 

0 


Keyboard Access: fPRG) fNxT) Hlifii ifilill 


Affected by Flags: None 


Remarks: DOERR causes a program to behave exactly as if a 
normal error has occurred during program execution. The error 
message depends on the argument provided to DOERR: 

■ terror or #n error display the corresponding built-in error message. 

■ "error" displays the contents of the string. (A subsequent execution 
of ERRM returns "error". ERRN returns # 70000h.) 

■ 0 abandons program execution without displaying a message—0 
DOERR is equivalent to pressing fCANCEL) . 

Example: The following program takes a number from the stack and 
returns an error if the number is greater than 10: 


*!** 

9 m 


u 


I f 


uhse 


' X> 1 0 


THEN "X IS TOO BIG" DOERR END 
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DOLIST 



Related Commands: ERR.M, ERRN, ERRO 


DOLIST 

Do to List Command: Applies commands, programs, or user-defined 

functions to lists. 


Level n...Level 3 Level 2 Level 1 -*■ Level 1 


{ list } x ... { list } n 

n 

<C program > 

■+ { results } 

{ list } x ... { list } n 

n 

command 

-+ { results } 

{ list } x ... { list } n 

n 

name 

-+ { results } 

{ list } x ... 

{ list } n 

< program > 

{ results } 

{ list } x ... 


command 

{ results } 

{ list } x ... 

{ list } n 

name 

-+ { results } 


Keyboard Access: (prgI lllli* Hills lips® 

• ■-t-tttt'Pit f ■!■ ■ b ■ i + i *1 i i i i i i i i i i i - - - - - — — — — - — — - - ■ - — — — ■ ■ rrTTT r r t p I ijina iiin -l^iiiiiiaaiiBriii'r 


Affected by Flags: None 

Remarks: The number of lists, 

argument is any of the following: 


n 


can be omitted when the level 1 


■ A command. 

■ A program containing exactly one command (e.g. <C DUP ^>). 

■ A program conforming to the structure of a user-defined function. 

The level 1 object can be a local or global name that refers to a 
program or command. 

All lists must be the same length /. The program is executed / times: 
on the zth iteration, n objects each taken from the *th position in each 
list are entered on the stack in the same order as in their original lists, 
and the program is executed. The results from each execution are left 
on the stack. After the final iteration, any new results are combined 
into a single list. 
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DOLIST 


Example: c l 



ll 


b 


45 








t 

* 




DOLI ST returns 


Related Commands: DOSUBS, ENDSUB. NSUB, STREAM 


DOSUBS 

Do to Sublist Command: Applies a program or command to groups 

of elements in a list. 


Level 3 

Level 2 

Level 1 —b 

Level 1 

{ list }! 

n 

< program > -*• 

{ list } 2 

{ list >1 

n 

command — ► 

{ Ust } 2 

{ list } 1 

n 

name — ► 

{ Ust } 2 


{ list 

< program > -+ 

{ Ust } 2 


{ Ust } i 

command — ► 

{ list } 2 


{ Ust }i 

name — ► 

{ list } 2 


Keyboard Access: 


■■■ ■■■ ■■■ 

(PRGIIII1 



Affected by Flags: None 


Remarks: The real number n can be omitted when the level 1 
argument is one of the following: 


■ A command. 

■ A user program containing a single command. 

■ A program with a user-defined function structure. 

■ A global or local name that refers to one of the above. 


The first iteration uses elements 1 through n from the list; the second 
iteration uses elements 2 through n+ 1; and so on. In general, the m th 
iteration uses the elements from the list corresponding to positions m 
through ra+n—1. 

During an iteration, the position of the first element used in that 
iteration is available to the user using the command NSUB, and 
the number of groups of elements is available using the command 
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DOSUBS 

ENDSUB, Both of these commands return an Undefined Local Name 
error if executed when DOSUBS is not active. 

DOSUBS returns the Invalid User Function error if the level 1 
argument is a user program that does not contain only one command 
and does not have a user-defined function structure. DOSUBS also 
returns the Wrong Argument Count error if the level 1 argument is 
a command that does not accept 1 to 5 arguments of specific types 
(DUP, ROT, or -+LIST, for example). 

Examples; -C R B C D E > « “ * DOSUBS returns 
€ 1 fl-B 1 ' B-C r 1 C-D 1 1 D-E 1 >. 

■C fl B C 2 - DUP * * & DOSUBS returns 
i 1 R*<B*B>''B*<C*C > 1 >. 


Entering 

- 1 " 1 O O .-‘I CT "i 

1 I <1 O H J _■ 

•y * M L 

v ' % ■ d D 


* CASE 'NSUB—1 ' THEN a END 
1 NSUB==ENDSUB 1 THEN b END 
'a+b' EVRL 


E N D 


:*■ 


DOSUBS 

returns 
•C 1 5 7 5 >. 

Related Commands; DOLIST, ENDSUB, NSUB, STREAM 
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DOT 


Dot Product Command: Returns the dot product A-B of two arrays 

A and B, calculated as the sum of the products of the corresponding 
elements of the two arrays. 


Level 2 

Level 1 


Level 1 

[ array A ] 

[ array B ] 

- 

X 


Keyboard Access: 



Affected by Flags: None 


Remarks: Both arrays must have the same dimensions. 


Some authorities define the dot product of two complex arrays as the 
sum of the products of the conjugated elements of one array with their 
corresponding elements from the other array. The HP 48 uses the 
ordinary products without conjugation. If you prefer the alternate 
definition, apply CONJ to one or both arrays before using DOT. 


Example: [ 1 2 3 1 [ 4 5 6 1 DuT returns 32 (by calculating 1x4 
+ 2 x 5 + 3 x 6). 


Related Commands: CNRM, CROSS, DET, RNRM 




Draw Plot Command: Plots the mathematical data in the reserved 
variable EQ or the statistical data in the reserved variable EDAT, 
using the specified x- and y -axis display ranges. 


Keyboard Access: 



Affected by Flags: Simultaneous or Sequential Plot (—28), Curve 
Filling (—31) 


Remarks: The plot type determines if the data in the reserved 
variable EQ or the data in the reserved variable EDAT is plotted. 
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DROP 


DRAW does not erase PICT before plotting—execute ERASE to do 
so. DRAW does not draw axes—execute DRAX to do so. 

When DRAW is executed from a program, the graphics display, which 
shows the resultant plot, does not persist unless PICTURE, PVIEW 
(with an empty list argument), or FREEZE is subsequently executed. 

Related Commands: AUTO, AXES, DRAX, ERASE, FREEZE, 
PICTURE, LABEL, PVIEW 


DRAX 

Draw Axes Command: Draws axes in PICT. 


Keyboard Access: 


TO(PLOT) BWEi 


Affected by Flags: None 


Remarks: The coordinates of the axes intersection are specified by 
AXES. Axes tick-marks are specified in PPAR with the ATICK, or 
AXES command. DRAX does not draw axes labels—execute LABEL 
to do so. 


Related Commands: AXES, DRAW, LABEL 


DROP 

Drop Object Command: Removes the level 1 object from the stack. 


Level 1 


obj 



Level 1 


Keyboard Access: f^flfpRoip) 

Affected by Flags: None 

Related Commands: CLEAR, DROPN, DROP2 
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DROPN 

Drop n Objects Command Removes the first n + 1 objects from the 
stack (the first n objects excluding the integer n itself). 



Level n+1 ... Level 2 


Level 1 


Level 1 


obj. 


obj„ 



Keyboard Access: 


STACK IINXT 


Mi# 


Affected by Flags: None 


Related Commands: CLEAR, DROP, DROP2 


DROP2 

Drop 2 Objects Command: Removes the first two objects from the 
st ack. 



Level 2 

Level 1 

■* Level 1 

obj 1 

obj 2 



Keyboard Access: 


STACK 1 f NXT1 


'.Wi'i 


1 


Affected by Flags: None 


Related Commands: CLEAR, DROP, DROPN 
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DTAG 

Delete Tag Command: DTAG removes all tags (labels) from an 

object. 


{} 

Level 1 -+ Level 1 


: tag: obj —* obj 


Keyboard Access: (prgi IBISI InxtI gS 


Affected by Flags: None 


Remarks: The leading colon is not shown for readability when the 
tagged object is on the stack. 


DTAG has no effect on an untagged object. 

Related Commands: LIST^, ^TAG 


DUP 


Duplicate Object Command: DUP returns a copy to level 1 of the 

object in level 1. 


Level 1 

■+ Level 2 

Level 1 

obj 

-+ obj 

obj 


Keyboard Access: 

Pressing (ENTER 1 duplicates the item on level 1 


(♦tK STACK 1 [NXT 1 i 


Affected by Flags: None 

Related Commands: DUPN ; DUP2, PICK 
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DUPN 

Duplicate n Objects Command: Takes an integer n from level 1 of 

the stack, and returns copies of the objects in stack levels 2 n through 
71+1. 


Lvl n+1...Lvl 2 Lvl 1 

-> Lvl 2n...Lvl n+1 

Lvl n...Lvl 1 

ofc/ n ... obj 1 n 

* obj n - - * obj ^ 

obj n ... obj 1 


Keyboard Access: stack ) fNxrl 



■i ’ 1 

li 

X: 1 


m 


i i-piji 


Affected by Flags: None 


Related Commands: DUP, DUP2, PICK 


DUP2 

Duplicate 2 Objects Command: DUP2 returns copies of the objects 

in levels 1 and 2 of the stack. 


Level 2 

Level 1 - 

■+ Level 4 

Level 3 

Level 2 

Level 1 

obj 2 

obj 1 

+ obj 2 

obj 1 

obj 7 

obj 1 


Keyboard Access: RtK stack 1 fNXTl SMB 

Affected by Flags: None 

Related Commands: DUP, DUPN, PICK 
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Degrees to Radians Function: Converts a real number representing 
an angle in degrees to its equivalent in radians. 



Level 1 


(tt/ 180) x 
'D—► R (sy/nfc)' 


Level 1 


'symb' 


Keyboard Access: (mthj 


■ i-*■ 


.p» 

• • • i it • ! ■ ■ ■ n i ■ 


• ■ ! n ■ ■ s r 


fit fNXT) fNXT) 



Affected by Flags: Numerical Results (—3) 


Remarks: This function operates independently of the angle mode. 

Related Commands R-»D 


e 

e Function: Returns the symbolic constant e or its numerical 
representation, 2.71828182846. 


Level 1 

- 

Level 1 



- 

■e' 

2.71828182846 

__ __ 


Keyboard Access: 

(a) S) E (ENTER I 


[MTH 1 (NXT) Ritlif 


Affected by Flags: Symbolic Constants (—2), Numerical Results 

(- 3 ) 
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When evaluated, e returns its numerical representation if flag —2 or 
flag —3 is set; otherwise, e returns its symbolic representation. 


Remarks: The number returned for e is the closest approximation 
of the constant e to 12-digit accuracy. For exponentiation, use the 
expression 1 EXPOO 1 rather than 




since the function EXP 


uses a special algorithm to compute the exponential to greater 
accuracy. 


Related Commands: EXP, EXPM, i, LN, LNP1, MAXR, MINR, tt 


EGV 

V 

Eigenvalues and Eigenvectors Command: Computes the 

eigenvalues and right eigenvectors for a square matrix. 


{} 


Level 1 

-> Level 2 

Level 1 

[[ matrix ]] A 

- [[ matrix ]] EVec 

[ vector ] EVa| 


Keyboard Access: (mth] BWBBI (nxt] 


Affected by Flags: None 



Remarks: The resulting vector EVal contains the computed 
eigenvalues. The columns of matrix EVec contain the right 
eigenvectors corresponding to the elements of vector EVal. 


The computed results should minimize (within computational 
precision): 

|A * EVec — EVec * diag(EVa/)| 

n ■ \A\ 

where diag(EVa/) denotes the n x n diagonal matrix containing the 
eigenvalues EVal. 

Related Commands: EGVL 
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EGVL 

Eigenvalues Command: Computes the eigenvalues of a square 

matrix. 


{} 



Level 1 

-> Level 1 


[[ matrix ]] A 

-*■ [ vector ] E v a , 


Keyboard Access: fMTHi ItfflllfS fNxT) a 


I P 111.1 r p - PPPP P " r « P I P B ¥ -, P -1 1 • 

■V mfcv.'m'pV.v.’J l'l*/; '.v.v,' 


Affected by Flags: None 

Remarks: The resulting vector L contains the computed eigenvalues. 


Related Commands: EGV 



ELSE Command: Starts false clause in conditional or error-trapping 
structure. 


See the IF and IF ERR keyword entries for syntax information. 

Keyboard Access: 


fPRGl 


mmm i 


! I I -I I I I i i I ri 




Hi 111 I ll^i i#Ma - . 

■v'-IvmVmIii!-’ 



• | i I • 4 d ■ 


i mmmm- ? 

■ > l> B ■ ■ i I i 

■ - 1 J p ■ ■ ■ r p r b b p 


fPRGl fNXTl IMiltt Wa&m 

■Ls- Jm yL- Jm r r.r...B-p«p - B ■ i .. . l . 1 1 J ■* - u u. l ... t . u ....... u - u ... s , 



f 


Remarks: See the IF and IFERR keyword entries for more 

information. 


Related Commands: 
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END 

END Command: Ends conditional, error-trapping, and indefinite loop 
structures. 

See the IF, CASE, IF ERR. DO, and WHILE keyword entries for 
syntax information. 

Keyboard Access: 








Remarks: See the IF, CASE, IFERR, DO, and WHILE keyword 

entries for more information. 

Related Commands: IF, CASE, DO, ELSE, IFERR, REPEAT, 
THEN, UNTIL, WHILE, 


ENDSUB 

Ending Sublist Command: Provides a way to access the total 
number of sub lists contained in the list used by DO SUBS. 

Keyboard Access: (prcP l»81pl llilHi IllIIl 

■r . . . ■ttpft-'ihiM-i.B ■I'lriiiiiiiiiirriiriiirrrrrrrrrrrrrrrr ■rtaiirv- - - 


Affected by Flags: None 

Remarks: Returns an Undefined Local Name error if executed when 
DOS UBS is not active. 

Example: The following program subtracts the number of elements 
in a list from each element in the list: 


"#■ a 


a 1 


•$: ENDSUB 
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ENG 



•V 





Related Commands; DOSUBS, NSVB 


ENG 

Engineering Mode Command: Sets the number display format to 

Engineering mode, which displays one to three digits to the left of the 
fraction mark (decimal point) and an exponent that is a multiple of 
three. The total number of significant digits displayed is n + 1. 


{} 

Level 1 -» Level 1 


n 


Keyboard Access: 


(«t1( MODES! 



Affected by Flags: None 





Remarks: Engineering mode uses n + 1 significant digits, where 
0 < n < 11. (Values for n outside this range are rounded up or down.) 
A number is displayed or printed as follows: 

(sign) mantissa E (sign) exponent 

where the mantissa is of the form (nn)n.(n ... ) (with up to 12 digits 
total) and the exponent has one to three digits. 

A number with an exponent of —499 is displayed automatically in 
Scientific mode. 


Example: The number 103.6 in Engineering mode with five 
significant digits (ft—4) would appear as 103.60E0. This same 
number with one significant digit (ft—0) would appear as 100. E0« 

Related Commands: FIX, SCI, STD 
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EQ-» 

Equation to Stack Command: Separates an equation into its left 

and right sides. 



Level 1 


Level 2 Level 1 


' s y mb l =symb 2 ' 

z 

'name* 
x_ unit 
'symb' 




1 symb 1 ' 
z 

'name' 
x_ unit 
1 symb' 


'symb 2 ' 
0 
0 
0 
0 




Keyboard Access: (prgI mini (nxtj H 

I • i i ----- 

Affected by Flags: None 

Remarks: If the argument is an expression, it is treated as an 
equation whose right side equals zero. 


Related Commands: ARRY—DTAG, LIST->, OBJ 




STR 


EQNLIB 


Equation Library Command: Starts the Equation Library 

application. 


Keyboard Access: RtUeq lib 1 gaag Bi 


■ i ill lii i I F FfFf ’ 

Mlu */' A 1 


» .. 


W'. 1 . m\ 




Affected by Flags: None 


Remarks: The Equation Library is a collection of equations and 
commands useful for solving typical science and engineering problems. 

Related Commands: MSOLVR, SOLVEQN 
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ERRM 


ERASE 

Erase PICT Command: Erases PICT, leaving a blank PICT of the 

same dimensions. 


Keyboard Access: 


f»l)fPICTURE 1 1111111 fNXTI ISSiSll 

*“■ . . 

ae 1CTURE If^l (CLEAR) 

O f PLOT 1 lift!! 

Affected by Flags: None 

Related Commands: DRAW 


ERRM 

Error Message Command: Returns a string containing the error 

message of the most recent calculator error. 


Level 1 

-+ Level 1 



-+ "error message " 

1 

Keyboard Access: (prg) (nx 

t) iiiiaii in® is 



Affected by Flags: None 

Remarks: ERRM returns the string for an error generated by 

DOERR. If the argument to DOERR was 0, the string returned by 
ERRM is empty. 

Example: The program ■£ IF ERR + THEN ERRM END s* returns "Bad 
firgunient Type" to level 1 if improper arguments (for example, a 
complex number and a binary integer) are in levels 1 and 2. 

Related Commands: DOERR, ERRN, ERRO 
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ERRN 

Error Number Command: Returns the error number of the most 

recent calculator error. 


Level 1 

- 

Level 1 



rror 


Keyboard Access: 


fPRGlfMXTl 




Affected by Flags: None 


Remarks: If the most recent error was generated by DO ERR with a 
string argument, ERRN returns # 70Q0Qh. If the most recent error 
was generated by DOERR with a binary integer argument, ERRN 
returns that binary integer. (If the most recent error was generated 
by DOERR with a real number argument, ERRN returns the binary 
integer conversion of the real number.) 


Example: The program ■*: IFERR + THEN ERRN END * returns 
# 202hi to level 1 if improper arguments (for, example, a complex 
number and a binary integer) are in levels 1 and 2. 

Related Commands: DOERR, ERRM, ERRO 


ERRO 


Clear Last Error Number Command: Clears the last error number 

so that a subsequent execution of ERRN returns # Qh, and clears the 
last error message. 


Keyboard Access: iprgi fNxrl HI! 
Affected by Flags: None 



Related Commands: DOERR, ERRM, ERRN 
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EVAL 


EVAL 

Evaluate Object Command: Evaluates the object. 


Level 1 

* Level 1 

obj 

+ (see below) 


Keyboard Access: f eval 1 

Affected by Flags: Numerical Results (—3) 

Remarks: The following table describes the effect of the evaluation 
on different object types. 


Obj. Type 

Effect of Evaluation 

Local Name 

Recalls the contents of the variable. 

Global Name 

Calls the contents of the variable: 

■ A name is evaluated. 

■ A program is evaluated. 

■ A directory becomes the current directory. 

■ Other objects are put on the stack. 

If no variable exists for a given name, evaluating 
the name returns the name to the stack. 

Program 

Enters each object in the program: 

■ Names are evaluated (unless quoted), 

■ Commands are evaluated. 

■ Other objects are put on the stack. 

List 

Enters each object in the list: 

■ Names are evaluated. 

■ Commands are evaluated. 

■ Programs are evaluated. 

m Other objects are put on the stack. 
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EVAL 


Obj. Type 

Effect of Evaluation 

j Tagged 

If the tag specifies a port, recalls and evaluates the 
specified object. Otherwise, puts the untagged 
object on the stack. 

Algebraic 

Enters each object in the algebraic expression: 

■ Names are evaluated. 

■ Commands are evaluated. 

■ Other objects are put on the stack. 

Command, 
Function, XLIB 
Name i 

Evaluates the specified object. 

Other Objects 

Puts the object on the stack. 


To evaluate a symbolic argument to a numerical result, evaluate the 
argument in Numerical Result mode (flag —3 set) or execute —>NUM 
on that function. 

Related Commands: —>NUM, SYSEVAL 


EXP 

Exponential Analytic Function: Returns the exponential, or natural 

antilogarithm, of the argument; that is, e raised to the given power. 


{} 



Level 1 

. Level 1 



Z - 

+ e z 



1 sym b' - 

» ' EXP {symb)' 



Keyboard Access: g)0 

Affected by Flags: Numerical Results (—3) 
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EXPAN 


Remarks: EXP uses extended precision constants and a special 
algorithm to compute its result to full 12-digit precision for all 
arguments that do not trigger and underflow or overflow error. 

EXP provides a more accurate result for the exponential than can be 
obtained by using e [ y* f The difference in accuracy increases as z 
increases. For example: 


z 

EXP(z) 

e z 

3 

10 i 

100 

500 

1000 

20.0855369232 

22026.4657948 

2.68811714182E43 

1.40359221785E217 

1.97007111402E434 

, 20.0855369232 

22026.4657949 

2.68811714191E43 

1.40359221809E217 

1.97007111469E434 


For complex arguments, 

e O,y) __ e x C0S y _j_ siny 

Related Commands: ALOG, EXPM, LN, LOG 


EXPAN 


Expand Products Command: Rewrites an 

equation by expanding products and powers. 

algebraic expression or 


{> 

Level 1 -► 

Level 1 

'symb-L 1 — ► 

'$ymb 2 1 

X —► 

X 

(x, y) -*■ 

(x. y) 


Keyboard Access: 
Affected by Flags: 


S) (sym bolic! Hill 

None 


Examples: ‘fl*(B+C) ’ EiPflN returns 1 fi*B+fl*C 
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EXPAN 


ft< B + C > 1 E X P ft N returns 1 ft Ei * ft •'*' C 1 . 


i y,-\isr i 
r "< 


EXPftN returns ’ X*X A 4 1 . 


! X * Y > - - 2 1 E X P ft N ret urns 1 X £ -f £ * X * Y * Y “*■ £ 1 . 

Related Commands: CGLCT, ISOL, QUAD SHOW 


EXPFIT 


Exponential Curve Fit Command: Stores EXPFIT as the fifth 

parameter in the reserved variable SPAR, indicating that subsequent 
executions of LR are to use the exponential curve fitting model. 


Keyboard Access: Q(sw)Hliil if! 


i-.-i 




mm 


Affected by Flags: None 


Remarks: UNFIT is the default specification in SPAR. For a 
description of SPAR , see appendix D, “Reserved Variables.” 


Related Commands: BESTFIT, LR, LINFIT, LOGFIT, PWRFIT 


EXPM 

Exponential Minus 1 Analytic Function: Returns e x - 1. 


{} 



Keyboard Access: 



fNXTTili! 


Affected by Flags: Numerical Results (—3) 


Remarks: For values of x close to zero, ' EXPM<ar) 1 returns a 
more accurate result than does ' EXP < z > -1 1 . (Using EXPM allows 
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EYEPT 


both the argument and the result to be near zero, and avoids an 
intermediate result near 1. The calculator can express numbers within 

10 449 Q f zero within only 10 —11 of 1.) 

Related Commands: EXP, LNPl 


EYEPT 

Eye Point Command: Specifies the coordinates of the eye point in a 

perspective plot. 


{} 


Level 3 

Level 2 

Level 1 

-► Level 1 


*poin t 

■'point 

^p o i n t 

- 



Keyboard Access: 




Affected by Flags: None 


Remarks: x pozn t , ypoint) and z pom t are real numbers that set the x-, 
y-, and z-coordinates as the eye-point from which to view a 3D plot’s 
view volume. The y-coordinate must always be 1 unit less than the 
view volume’s nearest point ( y nea r of YVOL). These coordinates are 
stored in the reserved variable VPAR. 


Related Commands: NUMX, NUMY, XVOL, XXRNG, YVOL 
YYRNG, ZVOL 
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FOA 

Black Body Emissive Power Function: Returns the fraction of total 

black-body emissive power. 



Level 2 Level 1 


^lam bda 

x T 

^lam bd a 

1 symb' 

'symb' 

X T 

[ symb 1 1 

l symb 2 


Level 1 

^power 

'F0A(y| ambda ,sym6)' 
1 FOA {symb,x T ) l 
1 FOA {symb 1 ,symb 2 ) 1 


Keyboard Access: 


r+TKEQ LIB) ins- 







Affected by Flags: Numerical Results (—3) 


Remarks: FOA calculates the fraction of total black-body emissive 
power at temperature x T between wavelengths 0 and 2/i am bda* If 
units are not specified, ^, ambda has implied units of meters and x T 
has implied units of K. 


FOA returns a dimensionless fraction. 


FACT 

Factorial (Gamma) Function: Provided for compatibility with the 
HP 28. FACT is the same as !. See !, 



Level 1 


Level 1 


n —> 

X —¥ 

1 symb 1 —♦ 


n\ 

r (x-fi) 

'(symb )! 1 
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FANNING 


Keyboard Access: None. Must be typed in. 


FANNING 

Fanning Friction Factor Function: Calculates the Fanning friction 

factor of certain fluid flows. 


{} 


Level 2 

Level 1 

-* Level 1 

X x / D 

y Rz 

-4 Xs 

fanning 

x xfD 

' symb 1 

'FANNINGO^/p, symb)' 

1 symb 1 

y Re 

+ 'FANNING(sy/77it>,y Re )' 

1 symb ± ' 

l symb 2 ' 

-+ 'FANN\NG(symb 1 ,symb 2 ) i 


Keyboard Access: f* j1(EQ~uBl HB Hill 


Affected by Flags: Numerical Results (—3) 


Remarks: FANNING calculates the Fanning friction factor, a 
correction factor for the frictional effects of fluid flows having constant 
temperature, cross-section, velocity, and viscosity (a typical pipe flow, 
for example). is the relative roughness (the ratio of the conduit 
roughness to its diameter). y Re is the Reynolds number. The function 
uses different computation routines for laminar flow (Re < 2100) and 
turbulent flow (Re > 2100). x x /£> and y RQ must be real numbers or 
unit objects that reduce to dimensionless numbers, and both numbers 
must be greater than 0. 

Related Commands: DARCY 
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FC? 

Flag Clear? Command: Tests whether the system or user flag 

specified by n fjag num5er is clear, and returns a corresponding test 
result: 1 (true) if the flag is clear or 0 (false) if the flag is set. 



Affected by Flags: None 

Related Commands: CF, FC?C, FS?, FS?C, SF 


FC?C 

Flag Clear? Clear Command: Tests whether the system or user flag 

specified by n tjag nurnber is clear, and returns a corresponding test 
result: i (true) if the flag is clear or 0 (false) if the flag is set. After 
testing, clears the flag. 

{} 


Level 1 

■+ Level 1 

"f 1 a g n u m b e r 

■+ 0/1 


Keyboard Access: 



























































































FFT 


Affected by Flags: None 

Example: If flag —44 is set, -44 FC?C returns 0 to level 1 and clears 
flag —44. 

Related Commands: CF, FC?, FS?, FS?C, SF 


FFT 

Discrete Fourier Transform Command: Computes the one- or 

two-dimensional discrete Fourier transform of an array. 


_ {} 

Level 1 -* Level 1 i 


[arrays — [ array ] 2 


Keyboard Access: Imthi fNxTI — 


iir-ii-irkthllh 


M 1 ■ ■ 


* 1 '■ 1 4 1 1 ■ ■ 



---■ 1 1-sfcl ! , 




Affected by Flags: None 


Remarks: If the argument is an IV-vector or an Nx 1 or 1 xN matrix, 
FFT computes the one-dimensional transform. If the argument is an 
MxN matrix, FFT computes the two-dimensional transform. M and 
N must be integral powers of 2, 


The one-dimensional discrete Fourier transform of an IV-vector X is 
the A r -vector Y where: 

Y k = ^2 X n e~^ , i = y/—l 

n —0 

for k = 0, 1, ..., N — 1. 


The two-dimensional discrete Fourier transform of an Af x TV matrix X 
is the MxN matrix Y where: 


Af-l N-l 


Y k i 




X 


mn 


2 m km 

M e 


2ir*I rt 
N 


m — Q n = 0 


for k — 0, 1 


} " * ? 


M — 1 and / = 0, 1, ..., IV—1. 
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FFT 


The discrete Fourier transform and its inverse are defined for any 
positive sequence length. However, the calculation can be performed 
very rapidly when the sequence length is a power of two, and the 
resulting algorithms are called the fast Fourier transform (FFT) and 
inverse fast Fourier transform (IFFT). 

The FFT command uses truncated 15-digit arithmetic and 
intermediate storage, then rounds the result to 12-digit precision. 

Related Commands: IFFT 


FINDALARM 

Find Alarm Command: Returns the alarm index n incJex of the first 

alarm due after the specified time. 


Level 1 


Level 1 


date 

{ date time } 
0 


n \ n d e x 
^index 
n index 


Keyboard Access: f^DfTiME) iieaffli SflH 


Affected by Flags: Date Format (-42) 


Remarks: If the level 1 argument is a real number date, 
FINDALARM returns the index of the first alarm due after 12:00 AM 
on that date. If the argument is a list £ date time >, it returns the 
index of the first alarm due after that date and time. If the argument 
is the real number 0, FINDALARM returns the first past-due alarm. 


For any of the three arguments, FINDALARM returns 0 if no alarm is 
found. 


Related Commands: DELALARM, RCLALARM, STOALARM 
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FINISH 

Finish Server Mode Command: Terminates Kermit Server mode in 
a device connected to an HP 48 


Keyboard Access: 



Affected by Flags: I/O Device flag (—33), I/O Messages (—39) 


Remarks: FINISH is used by a local Kermit device to tell a server 
Kermit (connected via the serial port or the IR port) to exit Server 
mode. 


Related Commands: BAUD, CKSM, KGET, PARITY, PKT, 
RECN, RECV, SEND, SERVER 


FIX 

Fix Mode Command: Sets the number display format to Fix mode, 
which rounds the display to n decimal places. 


__ _ {} 

Level 1 — Level 1 


n 


Keyboard Access: f^lfMODEsl 





kktiill LI I i i i i i ■ 

i • >|i< 




iLiL' ■ ini 


_■■■!* i- m i 


. L . 1 f I | | I I . J I I . I 


Affected by Flags: None 


Remarks: Fix mode shows n digits to the right of the fraction mark 
(decimal point), where 0 < n < 11. (Values for n outside this range 
are rounded to the nearest integer.) A number is displayed or printed 
as follows: 


(sign) mantissa 

where the mantissa can be of any form. However, the calculator 
automatically displays a number in Scientific mode if either of the 
following is true: 
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FIX 

■ The number of digits to be displayed exceeds 12. 

■ A nonzero value rounded to n decimal places otherwise would be 
displayed as zero. 

Example: The number 103.6 in Fix mode to four decimal places 
would appear as 103« 6000. 

Related Commands: FIX, SCI, STD 


FLOOR 


Floor Function: Returns the greatest integer that is less than or 
equal to the argument. 

■ 

{} 

Level 1 

^ Level 1 

X 

■+ n 

unit 

■+ /?_ unit 

' symb 1 

■* 'FLOOR (symb)' 


Keyboard Access: fMTHl 




Affected by Flags: Numerical Results (—3) 


Examples: 3„ 2 FLOOR returns 3; “3.2 FLOOR returns -4. 

Related Commands: CEIL, IP, RND, TRNC 
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FOR 

FOR Definite Loop Structure Command: Starts FOR ... NEXT 

and FOR ... STEP definite loop structures. 



Level 2 

Level 1 

FOR 

*sta rt 

^finish 

NEXT 

FOR 

*sta rt 

*fi nish 

STEP 


increment 

STEP 


symt> in crem en t 


Level 1 



Keyboard Access: 

To begin a definite loop: 


PRG 



■fTM' i_f 

wwwvwm 

.. . 

i h yuHnrr11 

b" i I i ill 
rirr-EHlIibl■ 
r P ■ + + + I Fl 1 I -i I 

■rpilsi! I 1 LL 



.■>'-- ‘■I ■ ^1- J ' "'Hrili 

-- r ft . - - r - ■ - - * - I * i ■ - . r r p i . 

r 1 -r - - -M L ‘■■I s lf | ri.E.i, 


To type FOR NEXT 





To type FOR STEP: 




Affected by Flags: None 


Remarks: Definite loop structures execute a command or sequence of 
commands a specified number of times. 


■ A FOR ... NEXT loop executes a program segment a specified 
number of times using a local variable as the loop counter. You can 
use this variable within the loop. The syntax is this: 


$start %finish FOR counter loop-clause NEXT 

FOR takes x stdrt and ar tinish from the stack as the beginning and 
ending values for the loop counter, then creates the local variable 
counter as a loop counter. Then, the loop clause is executed; 
counter can be referenced or have its value changed within the loop 
clause. NEXT increments counter by one, and then tests whether 
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counter is less than or equal to £fj n j S h * If so, the loop clause is 
repeated (with the new value of counter ). 

When the loop is exited, counter is purged. 

■ FOR ... STEP works just like FOR ... NEXT, except that it lets 
you specify an increment value other than 1. The syntax is: 

X$tart Xfinish 1" U.H. counter loop-cldUSC Xincrement Eh 

FOR takes ar start and n lsh from the stack as the beginning and 

ending values for the loop counter, then creates the local variable 
counter as a loop counter. Next, the loop clause is executed; counter 
can can be referenced or have its value changed within the loop 
clause. STEP takes x increment from the stack and increments 
counter by that value. If the argument of STEP is an algebraic 
expression or a name, it is automatically evaluated to a number. 

The increment value can be positive or negative. If the increment 
is positive, the loop is executed again when counter is less than or 
equal to £fj n ish • If increment is negative, the loop is executed 
when counter is greater than or equal to £ fir[ish * 

When the loop is exited, counter is purged. 

Example; The following program sums all odd integers in the range 1 
to 100: 

* 0 1 100 

FOR I I + 2 STEP 


Related Commands: NEXT, START, STEP 
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FP 

Fractional Part Function: Returns the fractional part of the 

argument. 


{} 

Level 1 

* Level 1 


X — 

> y 


x_ unit — 

» y^unit 


'symb 1 — 

* 'FP(symb)' 



h Hj ■ h 4 b n i w - - » r ■ n r r r r r ■ r r ill ■ b i an u a. n ■ l *i a. ■ •r«pf n + trj 1 ‘ t §■ ! l i 

Keyboard Access: (mth) subsht (nxt) isii@»i 


Affected by Flags: Numerical Results (—3) 

Remarks: The result has the same sign as the argument* 


Examples: -32.3 FP returns 

Related Commands: IP 


□ 3; 32.3_m FP returns 



Free RAM Card Command: Frees (makes independent ) the 
previously merged RAM in port 1* FREE is provided for compatibility 
with the HP 48SX, which could merge RAM in port 2 as well. See 


FREER 


Level 2 Level 1 -> Level 1 


{ 1 °port 

{name backup ... 

^library } ^port 

/?an?e bacK U p ^port 

"library ^port 
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Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: Any prior contents of the port are moved into user 
memory. If level 2 specifies backup or library objects, those objects 
are moved from port 0 to the newly freed RAM port. 

Related Commands: FREE!, MERGEl 


PKEE1 

Free RAM Card Command: Frees (makes independent ) the 

previously merged RAM in port L Any prior contents of the port are 
moved into user memory. If level 1 specifies backup or library objects, 
those objects are moved from port 0 to the newly freed RAM port. 


Level 1 


Level 1 


{name backup ... 

^library } 


name 


backup 


"library 


Keyboard Access: H-ilf library I llllll 


Affected by Flags: None 


Remarks: The list in level 1 can be empty (in which case no objects 
are moved to the newly independent RAM) or it can contain any 
number of backup names and library numbers. Level 1 cannot be 
completely empty, however. 

Related Commands: FREE, MERGE, MERGEl 
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Freeze Display Command: Freezes the part of the display specified 

by rc dlsp i a y area , so that it is not updated until a key is pressed. 



Level 1 


"displayarea 


Level 1 


Keyboard Access: 


fPRGl fNXTl 




Affected by Flags: None 


Remarks: Normally, the stack display is updated as soon as the 
calculator is ready for data input. For example, when HALT stops a 
running program, or when a program ends, any displayed messages 
are cleared. The FREEZE command “freezes 55 a part or all of the 
display so that it is not updated until a key is pressed. This allows, 
for example, a prompting message to persist after a program halts to 
await data input. 


^display area the sum of the value codes for the areas to be frozen: 


Display Area 

Value Code 

Status area 

i 

Stack/Command-line area 

2 

Menu area 



So, for example, 2 FREEZE freezes the stack/command-line area, 

3 FREEZE freezes the status area and the stack/command-line area, 
and 7 FREEZE freezes all three areas. 

Values of Tldisplay area ^ 7 or < 0 freeze the entire display (are 
equivalent to value 7). To freeze the graphics display, you must freeze 
the status and stack/command-line areas (by entering 3), or the entire 
display (by entering 7). 
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Examples: 

This program: 


“Ready for dai-: 


1 DISP 1 FREEZE HFlLT 


displays the contents of the string in the top line of the display, then 
freezes the status area so that the string contents persist in the display 
after HALT is executed: 


This program: 


0d 


@d 


PVIEW 


FREEZE 


selects the graphics display and then freezes the entire display so that 
the graphics display persists after the program ends. (If FREEZE was 
not executed, the stack display would be selected after the program 
ends.) 

To use FREEZE with PVIEW (or any graphics display), you must 
enter 3 or 7. 


Related Commands: CLLCD, DISP, HALT 


FS? 

Flag Set? Command: Tests whether the system or user flag specified 

by n fiag number * s set. and returns a corresponding test result: 1 
(true) if the flag is set or 0 (false) if the flag is clear. 


O 



Keyboard Access: 



Affected by Flags: None 


Related Commands: CF, FC?, FC?C, FS?C, SF 


3-124 Command Reference 























































FUNCTION 


FS?C 

Flag Set? Clear Command: Tests whether the system or user flag 

specified by n flag number is set, and returns a corresponding test 
result: 1 (true) if the flag is set or 0 {false) if the flag is clear. After 
testing, clears the flag. 


Level 1 

- 

Level 1 

"fl a g n u m ber 


0/1 


Keyboard Access: 



Affected by Flags: None 

Example: If flag —44 is set, -44 FS?C returns 1 to level 1 and clears 
flag —44. 

Related Commands: CF, FC?, FC?C, FS?, SF 


FUNCTION 

Function Plot Type Command: Sets the plot type to. FUNCTION. 

Keyboard Access: f^DfPLOT) M B 


Affected by Flags: Simultaneous Plotting (—28), Curve Filling 

(-31) 

Remarks: When the plot type is FUNCTION, the DRAW command 

plots the current equation as a real-valued function of one real 
variable. The current equation is specified in the reserved variable 
EQ. The plotting parameters are specified in the reserved variable 
PPAR< which has the form: 


x 


mm ? 


mm -■ 


! I 


:X 


max ? 


i/max* indep res axes ptype depend } 
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FUNCTION 

For plot type FUNCTION, the elements of PPAR are used as follows: 

■ <z m]n , t/ min > is a complex number specifying the lower left corner 
of PICT (the lower left corner of the display range). The default 
value is <. -6. 5j -3. 1 >. 

■ (jJmax) 2/max is a complex number specifying the upper right 
corner of PICT (the upper right corner of the display range). The 
default value is ■■ 6.5 ? 3 „ 2 > . 

■ indep is a name specifying the independent variable, or a list 
containing such a name and two numbers specifying the minimum 
and maximum values for the independent variable (the plotting 
range). The default value of indep is X. 

■ res is a real number specifying the interval (in user-unit 
coordinates) between plotted values of the independent variable, or 
a binary integer specifying the interval in pixels. The default value 
is 0, which specifies an interval of 1 pixel. 

■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin, a list specifying the tick-mark annotation, and two 
strings specifying labels for the horizontal and vertical axes. The 
default value is < 0 P 0 >. 

■ ptype is a command name specifying the plot type. Executing the 
command FUNCTION places the name FUNCTION in PPAR. 

u depend is a name specifying a label for the vertical axis. The default 
value is Y. 

The current equation is plotted as a function of the variable specified 
in indep. The minimum and maximum values of the independent 
variable (the plotting range) can be specified in indep \ otherwise, the 
values in (a: m j n) i min > an d '^max, Mm a X > (the display range) are 
used. Lines are drawn between plotted points unless flag —31 is set. 

If EQ contains an expression or program, the expression or program 
is evaluated in Numerical Results mode for each value of the 
independent variable to give the values of the dependent variable. If 
EQ contains an equation, the plotting action depends on the form of 
the equation, as shown in the following table. 
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GET 


Form of 

Current Equation 

Plotting Action 

* expr-expr 1 

Each expression is plotted separately. The 


intersection of the two graphs shows where 


the expressions are equal. 

1 name-expr 1 

Only the expression is plotted. 

1 indep-constant 1 

A vertical line is plotted. 


If flag —28 is set, all equations are plotted simultaneously* 

If the independent variable in the current equation represents a unit 
object, you must specify the units by storing a unit object in the 
corresponding variable in the current directory. For example, if the 
current equation is 1 X+3 _ r-j', and you want X to represent some 
number of inches, you would store l_in (the number part of the unit 
object is ignored) in X, For each plotted point, the numerical value of 
the independent variable is combined with the specified unit (inches in 
this example) before the current equation is evaluated. If the result is 
a unit object, only the number part is plotted. 

Related Commands: BAR, CONIC, DIFFEQ, GRIDMAP, 
HISTOGRAM, PARAMETRIC, PARSURFACE, PCONTOUR, 
POLAR, SCATTER, SLOPEFIELD, TRUTH, WIREFRAME 
YSLICE 


GET 

Get Element Command: Returns from the level 2 array or list (or 
named array or list) the real or complex number z get or object obj get 
whose position is specified in level 1. 
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GET 



Level 2 


Level 1 


Level 1 


[[ matrix ]] 
[[ matrix ]] 


name 


matrix 


" ame matrix 

[ vector ] 

[ vector ] 

'name^ c tor' 
'na/ 7 ?e vector 1 
{ list } 

{ H st } 


'name 11st ' 

' name \\st l 


p ositio n 


{ »row m 


col 


p ositio n 


{ rtrow m, 


{ n 


{ n 


col 


position 

| 

position 
positio n 

f 

position 


"positio n 
t ^position J 


position 


{ n 


positio n 


get 

Z get 

Z get 

z get 

z get 

z get 

z get 

z get 

°bjq e t 

°t > jg e t 

°Wget 


obj\ 


get 


■ ■ i lH. j' 

i ■■ 1L1L f I lB J , 


Keyboard Access: CprgI — iSiiil « 

Affected by Flags: None 

Remarks: For matrices, n poS i t ion i s incremented in row order. 
Examples: C C 2 3 7 3 E 3 2 9 ] C 2 1 3 3 3 C 2 3 > GET returns 
[[ 2 3 7 3 C 3 2 9 3 C 2 1 3 3 3 8 GET returns 1. 

{ABODE j C 1 > GET returns 1 R '. 


Related Commands: GETI, PUT, PUTI 
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GETI 


GETI 


Get and Increment Index Command: Returns from the level 2 array 

or list (or named array or list) the real or complex number z qQt or 
object obj get whose position is specified in level 1, along with the level 
2 argument and the next position in that argument. 


Level 2 

[[ matrix ]] 
[[ matrix ]] 

^ ame mtrx' 

'/7a/7?e m trx' 

[ vect ] 

[ vect ] 
'name yect 1 
f name vect 1 
{ list } 

{ list } 

name \]st * 


Level 1 

n posl 

{ n r m c >1 

^posl 

{ rt x m c } x 

^p o s 1 
t ^posl } 
"post 
{ ^posl } 
n posl 

i /? posi } 

^posl 

l ^P O S 1 } 



Level 3 

[[ matrix ]] 
[[ matrix ]] 

,n3me rntrx' 

?name mtrx 8 

[ vect ] 

[ vect ] 
l name yect 1 

8 name V€ ct' 

{ H$t } 

{ list } 
'name |jst 1 

■namelist 


Level 2 

Level 1 

°pos2 


2 get 

{ n r m c 

)2 

z get 

^pos2 


z get 

{ rt r m c 

3"2 

z get 

/? pos2 


z get 

{ ^pos2 

} 

z get 

^pos2 


z get 

{ ^pos2 

} 

z get 

n pos2 


ob h e t 

I ^pos2 

} 

ohj get 

fl pos2 



{ n pOS2 

} 

ob h e t 


Keyboard Access: (frg) llflllfl 



Affected by Flags: Index Wrap Indicator (—64) 


The Index Wrap Indicator flag is cleared on each execution of GETI 

until the position index wraps to the first position in the argument , at 

which point the flag is set. The next execution of GETI clears the flag 
again. 


Remarks: For matrices, the position is incremented in row order. 

Related Commands: GET, PUT, PUTI 
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GOR 


Graphics OR Command: Superimposes grob 1 onto grob t3r g Qt or 

PICT, with the upper left corner pixel of grob 1 positioned at the 
specified coordinate in grob t3rget or PICT. 


Level 3 

Level 2 

Level 1 

- 

Level 1 

rg et 

{ #n #m } 

grob 1 


^result 

g rob target 

(x,y) 

grob ! 


^result 

P/CT 

{ #n #m > 

grob 1 



PICT 

(x,y) 

grob x 

-» 



Keyboard Access: 




Affected by Flags: None 


Remarks: GOR uses a logical OR to determine the state (on or off) 
of each pixel in the overlapping portion of the argument graphics 
object. 


If the level 3 argument is any graphics object other than PICT , then 
grob result ls ^turned to the stack. If the level 3 argument is PICT , no 
result is returned to the stack. 


Any portion of grob 1 that extends past g7vb t3rgQt or PICT is 
truncated. 


Related Commands: GXOR, REPL, SUB 
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GRAPH 


GRAD 


Grads Mode Command: Sets Grads angle mode. 


Keyboard Access: Qf modes l jj j fj l 


m 



Affected by Flags: None 

Remarks: GRAD clears flag — 17 and sets flag —18, and displays the 
GRRD annunciator. 


In Grads angle mode, real-number arguments that represent angles are 
interpreted as grads, and real-number results that represent angles are 
expressed in grads. 

Related Commands: DEG, RAD 


GRAPH 

Picture Environment Command: Selects the Picture environment 

(selects the graphics display and activates the graphics cursor and 
Picture menu). 

Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: GRAPH is provided for compatibility with the HP 48S 
series, and is the same as the PICTURE command. See PICTURE. 

Related Commands: PICTURE, PVIEW, TEXT 
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GRIDMAP 

GRIDMAP Plot Type Command: Sets plot type to GRIDMAP. 


Keyboard Access: 


PLOT 1 (NXT 




i m k i | ■ f , ( | i ■ | ■ i 

B " ■ II* * ®f ’ " “t" >■- ■ . 1 - r . 

.■.fffe’.LVj.-rV.’.',V.V J'V 

” 4) J liBSliB i ib - - t- . 1 I. 

■ ■ L W e .irmr.i,««^ ! |ll I I 1 11 


* • *lb • -air* - -yin • • • 


Affected by Flags: None 


Remarks: When plot type is set GRIDMAP, the DRAW command 
plots a mapping grid representation of a 2*-vector-valued function of 
two variables. GRIDMAP requires values in the reserved variables 

EQ } VP A R , and PPAR, 

VPAR has the following form: 

i" 

^right 2/near 2/far ^low ^high ^rriin ^max V min V max ^eye 2/eye 
^eye ^step 2/step - = * 


For plot type GRIDMAP, the elements of VPAR are used as follows: 

■ £, eft and bright are real numbers that specify the width of the view 

space. 

■ ?/near and y 1ar are real numbers that specify the depth of the view 


space. 


low 


and 2 hiqh are real numbers that specify the height of the view 


space. 


x m]n and r max are real numbers the specify the input region’s 
width. The default value is <-T * 1). 


2 / min and ?/ m ax are real numbers that specify the input region’s 
depth. The default value is <-l1 >. 

a? eye , 2/eye j and z eye are real numbers that specify the point in 
space from which you view the graph. 


^step and 2/step are rea l numbers that set the number of 
x-coordinates versus the number of y-coordinates plotted, 
be used instead of (or in combination with) RES. 


These can 


The plotting parameters are specified in the reserved variable PPAR 
which has the following form: 

f <£min> 2/m in > '^max, 2/max > indep res axes piype depend } 

For plot type GRIDMAP, the elements of PPAR are used as follows: 


> 2 /m in ■' ^ not 
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GROB 


■ ^max i y max) is not used. 

■ indtp is a name specifying the independent variable. The default 
value of indep is X\ 

■ res is a real number specifying the interval (in user-unit 
coordinates) between plotted values of the independent variable, or 
a binary integer specifying the interval in pixels. The default value 
is 0, which specifies an interval of 1 pixel. 

■ axes is not used. 

■ ptype is a command name specifying the plot type. Executing the 
command GRIDMAP places the command name GRIDMAP in 

PPAR. 

m depend is a name specifying the dependent variable. The default 
value is Y. 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 

HISTOGRAM, PARAMETRIC, PARSURFACE, PCONTOUR, 

POLAR, SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, 

YSLICE 


—>GROB 

Stack to Graphics Object Command: Creates a graphics object 

representing the level 2 object, where the argument rc char size specifies 
the character size of the representation. 


{} 


Level 2 

Level 1 ->■ 

Level 1 

obj 

^charsize 

grob 

Keyboard Access: 

fPRGl ililliil iffli 



Affected by Flags: None 

Remarks: w char size can be 0, 1 (small), 2 (medium), or 3 (large). 
rc char s]ze = 0 is the same as n char s]ze — 3, except for unit objects 
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GROB 


and algebraic objects, where 0 specifies the Equation Writer application 
picture. 

Example; This program: 





GROB 


PICT 




returns a graphics object to the stack representing the EquationWriter 


application picture of 


I VJ — 


r_j * 


M 

i' ■« 


w 


then stores the graphics object in 


PICT and shows it in the graphics display with scrolling activated. 


Related Commands: 


LCD, LCD 


GXOR 

Graphics Exclusive OR Command: Superimposes grob 1 onto 

(/ro&target or PICT, with the upper left corner pixel of grob 1 
positioned at the specified coordinate in grob target or PICT. 


Level 3 

Level 2 

Level 

5fro£>t a r g et 

{ #n } 

grob x 

^target 

(x,y) 

grob x 

PICT 

{ #n #m } 

grob l 

PICT 

(x,y) 

grob x 


Level 1 


grob t 

grob 


esu It 


esu It 


Keyboard Access: 


f PRGl HfiSIlI 



Affected by Flags: None 


Remarks: GXOR is used for creating cursors, for example, to make 
the cursor image appear dark on a light background and light on 
a dark background. Executing GXOR again with the same image 
restores the original picture. 


GXOR uses a logical exclusive OR to determine the state of the 
pixels (on or off) in the overlapping portion of the argument graphics 
objects. 
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Any portion of grob 1 that extends past grob Urget 
truncated. 


or PICT is 


If the level 3 argument (the target graphics object) is any graphics 
object other than PICT , then grob rQS[in is returned to the stack. If 
the level 3 argument is PICT , no result is returned to the stack. 

Example: This program: 


* ERASE PICT MEG PICT 
GROB 5x5 iifi048R01i 


£ # 0d #0d > 
GXOR LflSTRRG 


r- v 

1" 'i 




turns on (makes dark) every pixel in PICT , then superimposes a 5 
x 5 graphics object on PICT at pixel coordinates £ # 0d # 0d T 
Each on-pixel in the 5 by 5 graphics object turns off (makes light) the 
corresponding pixel in PICT. Then, the original picture is restored by 
executing GXOR again with the same arguments. 

Related Commands: GOR, REPL, SUB 


*H 

Multiply Height Command: Multiplies the vertical plot scale by 



Level 1 

- 

Level 1 



^factor 

- 




Keyboard Access: RtHploti IS lifK (nxtI 
Affected by Flags: None 



Remarks: Executing *H changes the $/-axis display range—the 
j/ min and 2/max components of the first two complex numbers in the 
reserved variable PPAR. The plot origin (the user-unit coordinate of 
the center pixel) is not changed. 

Related Commands: AUTO, *w, YRNG 
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HALT 

Halt Program Command: Plaits program execution. 


Keyboard Access: f prg l (nxt 1 BiiKB I lfW 

- ■■■■■. 1, ■ .1 J ■ I j ■■ ■.■»■■!. > 1- + T4 ++ i ftr! ■ ■ . ■ I. I. »■ t I. i. I- h - - - ■ 


Affected by Flags: None 

Remarks: Program execution is halted at the location of the 
HALT command in the program. The HRLT annunciator is turned 
on. Program execution is resumed by executing CONT (usually by 
pressing SI (CONT)). Executing KILL (usually by pressing (PRGl 
f NXT 1 Mills ^BS) cancels all halted programs. 

Related Commands: CONT, KILL 


HEAD 

First Listed Element Command: Returns the first element of a list 

or string. 


Level 1 -* Level 1 

{ obj 1 ... obj„ } -> obj 1 

" string " —» "element" 


Keyboard Access: 



Affected by Flags: None 

Example: "Dead" HERD returns "D". 

The following program takes a list of coordinates {ABC} that 
define a right triangle, and finds the length of the hypotenuse AC: 


« DUP HERD SNAP REVLIST HERD 



For example, entering £ (@,0) (0, 3> 



returns 5. 
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HISTOGRAM 


Related Commands: TAIL 




Hexadecimal Mode Command: Selects hexadecimal base for binary 
integer operations. (The default base is decimal.) 


Keyboard Access: (WfW] WWM 



Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 


Remarks: Binary integers require the prefix #. Binary integers 
entered and returned in hexadecimal base automatically show the 
suffix h. If the current base is not hexadecimal, then you can enter a 
hexadecimal number by ending it with h. It will be displayed in the 
current base when it is entered. 


The current base does not affect the internal representation of binary 
integers as unsigned binary numbers. 

Related Commands: BIN, DEC, OCT, RCWS, STWS 


HISTOGRAM 


Histogram Plot Type Command: Sets the plot type to 
HISTOGRAM. 


Keyboard Access: 


S)(PLOT) (NXT) 



Affected by Flags: None 


Remarks: When the plot type is HISTOGRAM, the DRAW 

command creates a histogram using data from one column of the 
current statistics matrix (reserved variable EDAT). The column is 
specified by the first parameter in the reserved variable SPAR (using 
the XCOL command). The plotting parameters are specified in the 
reserved variable PPA R , which has the form: 



%min H 


Vmin'' < £,nax j Vmax > indep res axes piype depend > 
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HISTOGRAM 


For plot type HISTOGRAM, the elements of PPAR are used as 
follows: 

■ k £ m in, 2/ min ls a complex number specifying the lower left corner 
of PICT (the lower left corner of the display range). The default 
value is C-6.5? -3. 1). 

■ ££ m axi 2/max ) is a complex number specifying the upper right 
corner of FTCT (the upper right corner of the display range). The 
default value is <6,5? 3.2). 

■ indep is either a name specifying a label for the horizontal axis, or 
a list containing such a name and two numbers that specify the 
minimum and maximum values of the data to be plotted. The 
default value of indep is X. 

m res is a real number specifying the bin size, in user-unit coordinates, 
or a binary integer specifying the bin size in pixels. The default 
value is 0, which specifies the bin size to be 1/13 of the difference 
between the specified minimum and maximum values of the data. 

■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin, a list specifying the tick-mark annotation, and two 
strings specifying labels for the horizontal and vertical axes. The 
default value is < 0 ? 0 > . 

■ ptype is a command name specifying the plot type. Executing the 
command HISTOGRAM places the command name HISTOGRAM 
in PPAR . 

■ depend is a name specifying a label for the vertical axis. The default 
value is Y, 

The frequency of the data is plotted as bars, where each bar represents 
a collection of data points. The base of each bar spans the values of 
the data points, and the height indicates the number of data points. 
The width of each bar is specified by res. The overall maximum and 
minimum values for the data can be specified by indep; otherwise, the 
values in Ca; m j n , y min > and <x max , y max > are used. 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, PARAMETRIC, PARSURFACE, PCONTOUR, POLAR, 
SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, YSLICE 
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HISTPLOT 


Draw Histogram Plot Command: Plots a frequency histogram of the 

specified column in the current statistics matrix (reserved variable 

SDAT). 


Keyboard Access: 


QUID 



Affected by Flags: None 



Remarks: The data column to be plotted is specified by XCOL and 
is stored as the first parameter in the reserved variable SPAR. If no 
data column is specified, column 1 is selected by default. The y-axis is 
autoscaled and the plot type is set to HISTOGRAM. 


HISTPLOT plots relative frequencies, using 13 bins as the default 
number of partitions. The RES command lets you specify a different 
number of bins by specifying the bin width. To plot a frequency 
histogram with numerical frequencies, store the frequencies in SDAT 
and execute BINS and then BARPLOT. 


When HISTPLOT is executed from a program, the graphics display, 
which shows the resultant plot, does not persist unless PICTURE, 
PVIEW (with an empty list argument), or FREEZE is subsequently 
executed. 


Related Commands: BARPLOT, BINS, FREEZE, PICTURE, 
PVIEW, RES, SCATRPLOT, XCOL 


HMS+ 

Hours-Minutes-Seconds Plus Command: Returns the sum of two 

real numbers, where the arguments and the result are interpreted in 
hours-minutes-seconds format. 


{} 


Level 2 

Level 1 

■+ Level 1 

HMS 1 

hms 2 

- HMS X + HMS 2 
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Keyboard Access: 


f^lfTIMfl fNXT 11111 



Affected by Flags: None 

Remarks: The format for HMS (a time or an angle) is H.MMSSs , 
where: 

■ H is zero or more digits representing the integer part of the number. 

■ MM are two digits representing the number of minutes. 

■ SS are two digits representing the number of seconds. 

■ s is zero or more digits (as many as allowed by the current display 
mode) representing the decimal fractional part of seconds. 

Related Commands: HMS—►, -^HMS, HMS— 


HMS™ 

Hours-Minutes-Seconds Minus Command: Returns the difference 

of two real numbers, where the arguments and the result are 
interpreted in hours-minutes-seconds format. 


{} 


Level 2 

Level 1 ->■ 

Level 1 

HMS 1 

hms 2 

HMS 1 -HMS 2 

Keyboard Access: 

f+nfTIMEl fNXT) »l« 

| « 1 1 1 - ■ III > • HUH i > . l . 


Affected by Flags: None 

Remarks: The format for HMS (a time or an angle) is H.MMSSs , 

where: 

■ H is zero or more digits representing the integer part of the number. 

■ MM are two digits representing the number of minutes. 

■ SS are two digits representing the number of seconds. 

■ s is zero or more digits (as many as allowed by the current display 
mode) representing the decimal fractional part of seconds. 
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HMS 


Related Commands: HMS^, —►HMS, HMS+ 


HMS-* 


Hours-Minutes-Seconds to Decimal Command: Converts a real 

number in hours-minutes-seconds format to its decimal form (hours or 

degrees with a decimal fraction). 

{} 

Level 1 -*■ 

Level 1 

HMS — 

X 

... 


Keyboard Access: Q(tTmF) InxtI HlBl 



Affected by Flags: None 


Remarks: The format for HMS (a time or an angle) is H.MMSSs. 
where: 

■ II is zero or more digits representing the integer part of the number. 

■ MM are two digits representing the number of minutes. 

■ SS are two digits representing the number of seconds. 

■ s is zero or more digits (as many as allowed by the current display 
mode) representing the decimal fractional part of seconds. 

Related Commands: ->HMS, HMS+, HMS- 
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-+HMS 

Decimal to Hours-Minutes-Seconds Command: Converts a real 

number representing hours or degrees with a decimal fraction to 
hours-minutes-seconds format. 


{} 


Level 1 

- Level 1 


X 

■+ HMS 



. 

i- Jiu ■ ■ j j ■ ■ ■ ■ 

! ■ i - ■ l ft ■■ ■ j j - ft.* 


Keyboard Access: Q(tTme) Inxt) 1§1| 

Affected by Flags: None 

Remarks: The format for HMS (a time or an angle) is H.MMSSs , 
where: 

H is zero or more digits representing the integer part of the number. 

MM are two digits representing the number of minutes. 

SS are two digits representing the number of seconds. 

5 is zero or more digits (as many as allowed by the current display 
mode) representing the decimal fractional part of seconds. 

Related Commands: HMS^, HMS+, HMS- 


HOME 

HOME Directory Command: Makes the HOME directory the 

current directory. 

Keyboard Access: ItRihome) 

Affected by Flags: None 

Related Commands: CRDIR, PATH, PGDIR, UPDIR 
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IDN 


■ 

I 


i Function: Returns the symbolic constant % or its numerical 
representation. (0, 1). 

t 



Keyboard Access: 



(MTH ifNXT) 




Affected by Flags: Symbolic Constants (—2), Numerical Results 

(- 3 ) 


Evaluating i returns its numerical representation if flag —2 or —3 is 
set; otherwise, its symbolic representation is returned. 

Related Commands: e, MAXR, MINR, it 


IDN 

Identity Matrix Command: Returns an identity matrix; that 

is, a square matrix with its diagonal elements equal to 1 and its 
off-diagonal elements equal to 0. 


{} 


Level 1 


Level 1 


n 


[[ R-/nair/x identity ]] 


[[ matrix ]] 


[[ matrix 


id e n tity 


]] 


name 
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IDN 


Keyboard Access: (mth! iiSPfl 
Affected by Flags: None 




Remarks: The result is either a new square matrix, or it’s an existing 
square matrix with its elements replaced by the elements of the 
identity matrix, according to the argument in level 1. 

■ Creating a new matrix: If the argument is a real number n } a new 
real identity matrix is returned to level 1, with its number of rows 
and number of columns equal to n . 

■ Replacing the elements of an existing matrix: If the argument 
is a square matrix, an identity matrix of the same dimensions is 
returned. If the original matrix is complex, the resulting identity 
matrix will also be complex, with diagonal values < 1 3 0 >. 

If the argument is a name, the name must identify a variable 
containing a square matrix. In this case, the elements of the matrix 
are replaced by those of the identity matrix (complex if the original 
matrix is complex). 

Related Commands: CON 


IF 

IF Conditional Structure Command: Starts IF ... THEN ... END 

and IF ... THEN ... ELSE ... END conditional structures. 


Level 1 -» Level 1 

IF 

THEN T/F -> 

END — 

IF -*• 

THEN T/F 

ELSE -> 

END 



















Keyboard Access: fpRGl Mill! 


Affected by Flags: None 



Remarks: Conditional structures, used in combination with program 
tests, enable a program to make decisions. 

■ IF ... THEN ... END executes a sequence of commands only if a 
test returns a nonzero (true) result. The syntax is: 

IF test-clause THEN true-clause END 


IF begins the test clause, which must return a test result to the 
stack. THEN removes the test result from the stack. If the value is 
nonzero, the true clause is executed. Otherwise, program execution 
resumes following END. 

■ IF ... THEN ... ELSE ... END executes one sequence of 
commands if a test returns a true (nonzero) result, or another 
sequence of commands if that test returns a false (zero) result. The 
syntax is: 

IF test-clause THEN true-clause ELSE false-clause END 

IF begins the test clause, which must return a test result to the 
stack. THEN removes the test result from the stack. If the value 
is nonzero, the true clause is executed. Otherwise, the false clause 
is executed. After the appropriate clause is executed, execution 
resumes following END. 

The test clause can be a command sequence (for example, fi B ±) or 
an algebraic (for example, 1 R^B 1 ). If the test clause is an algebraic, 
it is automatically evaluated to a number (*—*NUM or EVAL isnt 
necessary). 

Related Commands: CASE, ELSE, END, IF ERR, THEN 
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IFERR 

If Error Conditional Structure Command Starts IFERR ... 

THEN ... END and IFERR ... THEN ... ELSE ... END error 

trapping structures. 

Keyboard Access: IprgI InxTI ilillS apple 

Affected by Flags: Last Arguments (—55) 

Remarks: Error trapping structures enable program execution to 
continue after a “trapped” error occurs. 

■ IFERR ... THEN ... END executes a sequence of commands if an 
error occurs. The syntax of IFERR ... THEN ... END is: 

IFERR trap-clause THEN error-clause END 
If an error occurs during execution of the trap clause: 

1. The error is ignored. 

2. The remainder of the trap clause is discarded. 

3. The key buffer is cleared. 

4. If any or all of the display is “frozen” (by FREEZE), that state is 
canceled. 

5. If Last Arguments is enabled, the arguments to the command 
that caused the error are returned to the stack. 

6 . Program execution jumps to the error clause. 

The commands in the error clause are executed only if an error is 
generated during execution of the trap clause. 

■ IFERR ... THEN ... ELSE ... END executes one sequence of 
commands if an error occurs or another sequence of commands 
if an error does not occur. The syntax of TFERR ,.. THEN ... 

ELSE ... END is: 


IFERR trap-clause THEN error-clause ELSE normal-clause END 

If an error occurs during execution of the trap clause, the same six 
events listed above occur. 

If no error occurs, execution jumps to the normal clause at the 
completion of the trap clause. 
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Example: The following program uses IFERR much like the built-in 
linear system of equations solver. The program takes a result vector 
and a matrix of coefficients and returns a least-squares solution to the 
equations. 

•^ab 


•*: IFERR a b / THEN LSQ END 


Related Commands: CASE, ELSE, END, IF, THEN 


IFFT 

I 

Inverse Discrete Fourier Transform Command: Computes the one- 

or two-dimensional inverse discrete Fourier transform of an array. 


{} 

Level 1 

-v Level 1 


[ array ] 1 

■+ [ array ] 2 



Keyboard Access: 


(MTH1 fNXTl 




Affected by Flags: None 


Remarks: If the argument is an A-vector or an Ax 1 or lxA 
matrix, IFFT computes the one-dimensional inverse transform. If the 
argument is an M x A matrix, IFFT computes the two-dimensional 
inverse transform. M and A must be integral powers of 2. 


The one-dimensional inverse discrete Fourier transform of an A-vector 
Y is the A-vector X where: 


X 


n 


l 
N 


N—l 


'£Y l e“ 


ik n 
JV 


V—i 


k~Q 


for n = 0, 1, A r — 1. 
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IFFT 


The two-dimensional inverse discrete Fourier transform of an M x N 
matrix Y is the M X N matrix A' where: 

2 7 rikm 2 n il n 

\e M e tt " , 

fe = 0 /=o 

for m = 0, 1, M — 1 and n — 0, 1, ..., IV — 1. 

The discrete Fourier transform and its inverse are defined for any 
positive sequence length. However, the calculation can be performed 
very rapidly when the sequence length is a power of two, and the 
resulting algorithms are called the fast Fourier transform (FFT) and 
inverse fast Fourier transform (IFFT). 

The IFFT command uses truncated 15-digit arithmetic and 
intermediate storage, then rounds the result to 12-digit precision. 

Related Commands: FFT 





1 


M-1N-1 


mn 


MN 



I FT 


IF-THEN Command: 

T/F is zero. 

Executes obj if T/F is 

nonzero. Discards obj if 

Level 2 

Level 1 * 

Level 1 

T/F 

obj 

ft depends! 

Keyboard Access: 

Affected by Flags: 

fPRG I iftRi ffl® f NXT | Hit 

1 M 1 ■ ■ 1 1. 1. ■ B B fe » i. « S fr r r « «■ r ■ 1* ^ — e J J p J - J J JT i . . i ' B '»' 

None 

|- --r- rP- --- 

i . j ttr-j fc-p-.-------- 


Remarks: IFT lets you execute in stack syntax the decision-making 
process of the IF ... THEN ... END conditional structure. The “true 
clause” is obj in level 1. 


Example: 


I 1 


0 


"Positive" IFT s- puts "Positi^e" in level 1 


if X contains a positive real number. 


Related Commands: IFTE 
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IFTE 


IFTE 

IF-THEN-ELSE Function: Executes the obj on level 2 if T/F is 

nonzero. Executes the obj on level 1 if T/F is zero. 


Level 3 

Level 2 

Level 1 

- Level 1 

T/F 

ob h r u e 

ob A a lse 

■+ It depends! 


Keyboard Access: fPRG) iigBil [nxt] limil 

■ ■ ■ ■* ■ FI a I I M 1 ■ ■ 


Affected by Flags: None 


Remarks: IFTE lets you execute in stack syntax the decision-making 
process of the IF ... THEN ... ELSE ... END conditional structure. 
The “true clause” is obj tTUQ in level 2. The “false clause” is obj Uise in 
level 1. 


IFTE is also allowed in algebraic expressions, with the following 
syntax: 

1 IFTE<Tes^n/e-c/ause,/a/se-c/ause> 1 

When an algebraic containing IFTE is evaluated, its first argument 
test is evaluated to a test result. If it returns a nonzero real number, 
true-clause is evaluated. If it returns zero, false-clause is evaluated. 



Examples: The command sequence K 0 ^ "Positive" 
"Megat iue" IFTE leaves "Posit iye" on 
non-negative real number, or "Negative 11 
real number. 


stack if X contains a 
if X contains a negative 


The algebraic J IFTE 1 " 

sin(r)/a:, even for x — 


SIN < X > ? 1 > 1 returns the value of 

0 , which would normally cause an Inf inite 


Result error. 


Related Commands: IFT 
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IM 

Imaginary Part Function: Returns the imaginary part of its 
(complex) argument. 



Level 1 

X 

(» y) 

[ R-array ] 
[ C-array ] 
'symb* 


Level 1 

o 

y 

[ R-array ] 
[ R-array ] 
'IM( symbY 


Keyboard Access: (mth! (nxt) 



Affected by Flags: Numerical Results (—3) 


Remarks: If the argument is an array, IM returns a real array, 
the elements of which are equal to the imaginary parts of the 
corresponding elements of the argument array. If the argument array 
is real, all of the elements of the result array are zero. 


Related Commands: C->R, RE. R-+C 


I NCR 

Increment Command: Takes a variable on level 1, adds 1, stores the 
new value back into the original variable, and returns the new value to 
level 1. 


{} 


Level 1 

- Level 1 

'name 1 

^increment 
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Keyboard Access: f+ilfMEMORYi 

Affected by Flags: None 



Remarks: The value in name must be a real number. 
Example: If 35. 7 is stored in A, ' fl' I NCR returns 36.7. 

Related Commands: DECR 


INDEP 

Independent Variable Command: Specifies the independent variable 

and its plotting range. 


Level 2 

Level 1 


Level t 

*sta rt 

' global ' 

{ global } 

{ global x start x end } 

i *start *end / 

*end 

- 

1 


Keyboard Access: 


^ ■■ ■ •n ■ i m ■ ■■ ir “ — —~ ■■ ■ . t ■ ■ a ■» ■ ■ w i r ■ 

[4-ll PLOT] IBIfflffil i M 1 




Affected by Flags: None 


Remarks: The specification for the independent variable name and 
its plotting range is stored as the third parameter in the reserved 
variable PPAR. If the argument to INDEP is a: 

■ Global variable name, that name replaces the independent variable 

entry in PPAR. 


m List containing a global name, that name replaces the independent 
variable name but leaves unchanged any existing plotting range. 

■ List containing a global name and two real numbers, that list 
replaces the independent variable entry. 
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INDEP 


■ List containing two real numbers, or two real numbers from levels 1 
and 2, those two numbers specify a new plotting range, leaving the 
independent variable name unchanged. (LASTARG returns a list, 
even if the two numbers were entered separately.) 

The default entry is X. 

Related Commands: DEPND 


INFORM 

User-Defined Dialog Box Command: Creates a user-defined input 

form (dialog box). 


Lvl 5 

Lvl 4 


Lvl 3 

Lvl 2 

Lvl 1 - 

Lvl 2 

Lvl 1 

” title" 

{ s l s 2 "- s n 

} 

format 

{ resets } 

{ init } — > 

{ vals } 

1 

" title" 

{ s i s 2 • -* s n 

} 

format 

{ resets } 

{ init } —► 


0 


Keyboard Access: (prcT 
Affected by Flags: None 



Remarks: INFORM creates a standard dialog box based upon the 

following specifications: 
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INFORM 



If you exit the dialog box by selecting or [ENTER], INFORM 


returns the field values { vals } on level 2, and puts a 1 on level 1. (If 
a field is empty, NOVAL is returned as a place holder.) If you exit the 


dialog box by selecting EH§|B.;L or [CANCEL], INFORM returns 0. 
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INFORM 

Example: If the following five lines are on the stack: 


Column count 
Reset values - 


Title text 


Help text 


Empty field Field definition 


"The Title" 

{ { "ONE" "Name?" 2 } { } { 
{ "THREE" "Lucky numbers? 
{ 2 } 

{ NOVAL NOVAL {123}} 

{ "Charlotte" NOVAL {456 


"TWO" "Age?" } 
5 } } 

'-Allowed object type 

} } 


Field 1 default value Field 2 place holder 


Field 3 default value 


Pressing IMEIII® would produce: 

■-< i t ^ J i n i ■ ■ i -r i i i i ■ i i i i i i i i 



THE TITLE 


DNE 

TWQ 


"Char1 otte 


THREE 


f 4 


III 


NAME? 


EDIT 



»:hn«:l dk 


Related Commands: CHOOSE, INPUT, NOVA1, TYPE 


INPUT 

Input Command: Prompts for data input to the command line and 
prevents the user access to stack operations* 


Level 2 Level 1 — Level 1 

” stack prompt ’ " command-line prompt ' —► ” result ' 
" stack prompt" { list c om m and-line > "result' 
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Keyboard Access: (prg) CnxT) 

Affected by Flags: None 



mm 


Remarks: When INPUT is executed, the stack area is blanked and 
program execution is suspended for data input to the command line. 
The contents of "stack prompt" are displayed at the top of the stack 
area. Depending on the level 1 argument, the command line may also 
contain the contents of a string, or it may be empty. Pressing fENTERl 
resumes program execution and returns the contents of the command 
line in string form to level 1. 

In its general form, the level 1 argument for INPUT is a list that 
specifies the content and interpretation of the command line. The list 
can contain one or more of the following parameters, in any order: 


u "command-line prompt n , whose contents are placed in the command 
line for prompting when the program pauses. 

■ Either a real number, or a list containing two real numbers, that 
specifies the initial cursor position in the command line: 

□ A real number n at the nth character from the left end of the 
first row (line) of the command line. A positive n specifies the 
insert cursor; a negative n specifies the replace cursor. 8 specifies 
the end of the command-fine string. 

□ A list that specifies the initial row and column position of 
the cursor: the first number in the list specifies a row in the 
command line (1 specifies the first row of the command line); 
the second number counts by characters from the left end of the 
specified line. 8 specifies the end of the command-line string in 
the specified row. A positive row number specifies the insert 
cursor; a negative row number specifies the replace cursor. 


■ One or more of the parameters RLG, or V, entered as unquoted 

names: 


n RLG activates Algebraic/Program-entry mode. 

□ <:■: ((a) IrHfAl ) specifies alpha lock. 

□ V verifies if the characters in the result string "result", without 
the " delimiters, compose a valid object or objects. If the 
result-string characters do not compose a valid object or objects, 
INPUT displays the Invalid Syntax warning and prompts 
again for data. 
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You can choose to specify as few as one of the level-1 list parameters. 
The default states for these parameters are: 

■ Blank command line. 

■ Insert cursor placed at the end of the command-line prompt string. 

■ Program-entry mode. 

■ Result string not checked for invalid syntax. 

If you specify only a command-line prompt string for the level 1 
argument, you don’t need to put it in a list. 

Related Commands: PROMPT, STR^ 


INV 

Inverse (1/x) Analytic Function: Returns the reciprocal or the 

matrix inverse. 


{} 

Level 1 

* Level 1 


Z 

■* 1 /z 


[[ matrix ]] 

■+ [[ matrix ]] -1 


'syrnb 1 

4 ' IN' V(symb)' 


x_ unit 

4 1 /x-l/unit 



Keyboard Access: (ijx) 

Affected by Flags: Numerical Results (—3) 

Remarks: For a complex argument (zr, $), the inverse is the complex 
number (^f--*, 

Matrix arguments must be square (real or complex). The computed 
inverse matrix A" 1 satisfies Ax A 1 — J n , where I n is the nxn identity 
matrix. 

Related Commands: SINV, / 
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Integer Part Function: Returns the integer part of its argument. 



Level 1 


n 

n_unit 
l \P(symb) l 


Level 1 


unit 

' symb ' 


k ■ ■ ■ ■ b I i hi 


Keyboard Access: Imthi llliiil (nxt| 

Affected by Flags: Numerical Results (—3) 


■ ^1 ■ i ■ 




Remarks: The result has the same sign as the argument. 
Example: 32.3_n IP returns 32_n. 

Related Commands: FP 



Infrared/Serial Transmission Command: Directs I/O and printer 

output to the infrared or serial port ("wire"). 


Keyboard Access: 
Affected by Flags: 




% ■ ■ ■ ■ ■ ■ i 



• 1 1 i-| r i i p| | | 


I/O Device (—33), Printing Device (—34) 


Remarks: Toggles between IR and wire. 

For more information, refer also to the reserved variable 10PAR ( I/O 
parameters ) in appendix D, “Reserved Variables,” 

Related Commands: BAUD, CKSM, PARITY, TRANSIO 
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ISOL 

Isolate Variable Command: Returns an algebraic 1 symb 2 1 that 

rearranges 1 symb 1 1 to “isolate 1 ' the first occurrence of variable global. 


{} 


Level 2 

Level 1 

Level 1 

'symb x ' 

1 global' 

'symb 2 1 

Keyboard Access: 

Affected by Flags: 



Rr) (symbolic) jUi 

Principal Solution (- 

IfMiV'i'iV'Vl'-ViV 

■1-1 ' 1 1 1 • » i i • 1 • 

. . . i 1 i rf ■s« 

-tank* ■* 'Iihi . * i «■ 

-1), Numerical Results (—3) 


When flag —3 is set, symbolic results are evaluated to real numbers. 
This means that the = sign is evaluated. If global or any other variable 
in the result equation is formal, an IJndef ined Name error results; 
if global and all other variables have values, a numerical result is 
returned from the calculation global — expression . This result has 
limited value. In general, execute ISOL with flag —3 clear. 

Remarks: The result 1 symb 2 1 is an equation of the form 
1 global-expression 1 . If global appears more than once, then 1 symb 2 1 
is effectively the right side of an equation obtained by rearranging and 
solving 1 symb 1 1 to isolate the first occurrence of global on the left¬ 
side of the equation. 

If ' $ymb 1 1 is an expression, it is treated as the left side of an 
equation 1 symb 1 =0 1 . 

If global appears in the argument of a function within 1 symb 1 1 , that 
function must be an analytic function—a function for which the HP 48 
provides an inverse. Thus ISOL cannot solve ' IP00-0 1 for X, since 
IP has no inverse. 

Related Commands: COLCT, EXPAN, QUAD, SHOW 
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KERRM 

Kermit Error Message Command: Returns the text of the most 

recent Kermit error packet. 


Level 1 

■ ■ ■ I fi ■ •, t 



Level 1 

" error-message " 


Keyboard Access: 


ol fNXTl 9BSS 



'Vi i ■« r 

I n a ■ a 


Affected by Flags: None 


Remarks: If a Kermit transfer fails due to an error packet sent from 
the connected Kermit device to the HP 48, then executing KERRM 
retrieves and displays the error message. (Kermit errors not in packets 
are retrieved by ERRM rather than KERRM.) 

Related Commands: FINISH, KGET, PKT, RECN, RECV, SEND, 
SERVER 


KEY 

Key Command: Returns to level 1 a test result and, if a key is 
pressed, returns to level 2 the row-column location x n m of that key. 


Level 1 




Level 2 Level 1 


m 


1 

0 


Keyboard Access: iprgi nxt! iiJWf®® ills® 

.. . . ... .. 

Affected by Flags: None 

Remarks: KEY returns a false result (y) to level 1 until a key is 
pressed. When a key is pressed, it returns a true result (1) to level 
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KEY 


1 and £ nm to level 2. The result £ nm is a two-digit number that 
identifies the row and column location of the key just pressed. Unlike 
WAIT, which returns a three-digit number that identifies alpha and 
shifted keyboard planes, KEY returns the row-column location of any 
key pressed, including S)> ©. and ©• 


Example: The program ■£ DO UNTIL KEY END 71 SR ME & returns 
1 to the stack if the si key is pressed while the indefinite loop is 
running. 


Related Commands: WAIT 


KGET 

Kermit Get Command: Used by a local Kermit to get a Kermit 

server to transmit the named object(s). 


Level 1 


1 name 1 
" name" 

{ na/r?e old name new } 
{ name 1 ... name n } 
{{ name Qld name new } name 




Level 1 


Keyboard Access: 



Affected by Flags: I/O Device (—33), RECV Overwrite (—36), I/O 
Messages (—39) 


I/O Data Format (—35) also affects KGET as follows: 

■ If the server is an HP 48. then the server’s flag —35 affects KGET. 


■ If the server is not an HP 48 but the file being transferred 
originated from an HP 48, flag —35 has no effect. 

■ If the server is not an HP 48 and the file being transferred does not 
have the %%HP» * „ « ? header, flag —35 tells the HP 48 whether to 
attempt parsing the incoming data. 
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KILL 


Remarks: To rename an object when the local device gets it, 
include the old and new names in an embedded list. For example, 

£*C RRR EBB >> KGET gets the variable named AAA but changes its 
name to EBB. £ C ftRfl BBB > CCC > KGET gets AAA as EBB and 
gets CCC under its own name. (If the original name is not legal on 
the HP 48, enter it as a string.) 


Related Commands: BAUD, CKSM, FINISH, PARITY, RECN, 
RECV, SEND, SERVER, TRANSIO 


KILL 


Cancel Halted Programs Command: Cancels all currently halted 

programs. (Halted programs are typically canceled by pressing [PRG] 
(NXT | IIBI UliTg.) If KILL is executed within a program, that 

“ - .y,y. ~-.y7vT7>-v-/ a O J 

program is also canceled. 


■■■■■■L.-r 


I ■ I ■ i f i I i MM ■ « >1 ''"'Simisi 

I I | II ■ I '■ I I «fHI | ■ ■■■!- 

> »*■■■. " * , I - " ■ ■ 

H lillll HJ ■ ■fm I ■ ■ ■ 

1 1'*!.(■ - ■- 1 

. tr- . fe . . . m* ■ U™ - 1 II ■ 




Keyboard Access: fpRGl fNxT) M 
Affected by Flags: None 

Remarks: Canceled programs cannot be resumed. 

KILL cancels only halted programs and the program from which KILL 
was executed, if any. Commands that halt programs are HALT and 

PROMPT. 


Suspended programs cannot be canceled. Commands that suspend 
programs are INPUT and WAIT. 

Related Commands: CONT, DOERR, HALT, PROMPT 
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LABEL 


Label Axes Command: Labels axes in PICT with x- and iy-axis 

variable names and with the minimum and maximum values of the 
display ranges. 


Keyboard Access: Q(plot) fNXT 
Affected by Flags: None 



." " ■ ’ i ■ ! § 1 P 1 

■ ■ ■ ■ f i 1 1 F III 1 ! > !l 


Remarks: The horizontal axis name is chosen in the following 
priority order: 


1. If the axes parameter in the reserved variable PPAR is a list, then 
the x-axis element from that list is used. 


2. If axes parameter is not a list, then the independent variable name 
in PPAR is used. 

The vertical axis name is chosen in the following priority order: 

1. If the axes parameter in PPAR is a list, then the y-axis element 
from that list is used. 

2, If axes is not a list, then the dependent variable name from PPAR 
is used. 

Related Commands: AXES, DRAW, DRAX 


LAST 

Last Arguments Command: Returns copies of the arguments of the 

most recently executed command. 

Keyboard Access: None. Must be typed in. 

Remarks: LAST is provided for compatibility with the HP 28S. 
LAST is the same as LASTARG. See LASTARG. 
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LASTARG 

Last Arguments Command: Returns copies of the arguments of the 

most recently executed command. 


Level 1 

■+ Level n 

* * * 

Level 1 

— 

-*■ Obj n 

* * * 

ob h 


Keyboard Access: 

®(ARG) 


pRGj (nxt) np mam 


Affected by Flags: Last Arguments (—55) 

Remarks: The objects return to the same stack levels that they 
originally occupied. Commands that take no arguments leave the 
current saved arguments unchanged. 


When LASTARG follows a command that evaluates an algebraic 
expression or a program (as do d, J, TAYLR, COLCT, DRAW, 
ROOT, ISOL, EVAL, and —►NUM), the last arguments saved are from 
the evaluated algebraic expression or program, not from the original 
command. 


Related Commands: LAST 


LCD—* 

LCD to Graphics Object Command: Returns the current stack and 
menu display as a 131 x 64 graphics object. 


Level 1 


Level 1 


grob 
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LCD 


Keyboard Access: (prgi MMBSi Inxt) ■Hi® 

Affected by Flags: None 

Example: LCD* PICT STO PICTURE returns the current display to 
level 1 as a graphics object, stores it in PICT, then shows the image 
in the Picture environment. 


Related Commands: 


GROB 


LCD 


-LCD 

Graphics Object to LCD Command: Displays the graphics object 

from level 1, with its upper left pixel in the upper left corner of the 
display. 



Affected by Flags: None 

Remarks: If the graphics object is larger than 131 X 56, it is 

truncated. 

Related Commands: BLANK, —>GROB, LCD—► 
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LIBEVAL 

Evaluate Library Function Command: Evaluates unnamed library 

functions. 



Level 1 


# n fun 


ctio n 


Level 1 


Keyboard Access: None. Must be typed in. 

Affected by Flags: None 


Remarks: Using LIBEVAL with random addresses can corrupt 
memory. #n tunction is of the form lllfffh, where III is the library 
number, and fff the function number. 


Related Commands: EVAL, SYSEVAL 


LIBS 

Libraries Command: Lists the title, number, and port of each library 
attached to the current directory. 


Level 1 


Level 1 


{ "title" n tih n 


H 


lib "port 


title" n ti u n 


lib port 


} 


Keyboard Access: f+TH library] lltt 
Affected by Flags: None 


Remarks: The title of a library often takes the form 
LIBRARY-NAME : Description. A library without a title is displayed 


Related Commands: ATTACH, DETACH 
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LINE 

Draw Line Command: Draws a line in PICT between the 

coordinates in levels 1 and 2. 


Level 2 

Level 1 

-+ Level 1 

(*1 ■ Vl ) 

( x 2 , y 2 ) 


{ # /?! # m 1 } 

{ # n 2 # m 2 } 

■+ 


Keyboard Access: 





Affected by Flags: None 


Example: This program: 


0,0) 


r 'J ‘i 

\ «L. H 


LINE 


# 0d # @d 


PVIEU 


FREEZE 


draws a line in PICT between two user-unit coordinates, displays 
PICT with pixel coordinate L # 0d # 0d > at the upper left corner of 
the picture display, and freezes the display. 

Related Commands: ARC, BOX, TLINE 


ILINE 

Regression Model Formula Command: Returns an expression 

representing the best fit line according to the current statistical model, 
using X as the independent variable name, and explicit values of the 
slope and intercept taken from the reserved variable SPAR. 



Level 1 


Level 1 


sy/T?fc> form □ i a 


Keyboard Access: 


STAT 1 


- ™-■ ----"i ; 1 » ■ 4 4 
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Affected by Flags: None 

Remarks: For each curve fitting model, the following table indicates 
the form of the expression returned by ELINE, where m is the slope, x 
is the independent variable, and b is the intercept. 


— 

Model 

Form of Expression 

LINFIT 

mx + b 

LOGFIT 

m ln(x) + b 

EXPFIT 

6e mx 

PWRFIT 

bx m 


Example: If the current model is EXPFIT, and if the slope is 5 and 


the intercept 3, ELINE returns 



Related Commands: BESTFIT, COLE, CORR, COV, EXPFIT, 
LINFIT, LOGFIT, LR, PREDX, PREDY, PWRFIT, XCOL, YCOL 


LINFIT 


Linear Curve Fit Command: Stores LINFIT as the fifth parameter in 

the reserved variable E PAR, indicating that subsequent executions of 
LR are to use the linear curve fitting model. 


Keyboard Access: 



Affected by Flags: None 


Remarks: LINFIT is the default specification in SPAR . For a 
description of EPAR , see appendix D, “Reserved Variables.” 


Related Commands: BESTFIT, EXPFIT, LOGFIT, LR, PWRFIT 
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LININ 


Linear Test Function: Tests whether an algebraic is structurally 
linear for a given variable. 

_ {} 

Level 2 Level 1 -+ Level 1 

1 syrrrb* l rrame l -+ 0/1 


Keyboard Access: (pro 





Affected by Flags: None 


Remarks: If any two subexpressions containing a variable (name) are 
combined only with addition and subtraction, and any subexpression 
containing the variable is at-most multiplied or divided by another 
factor not containing the variable, the algebraic ( 1 symb ') is 
determined to be linear for that variable. 


LININ returns a 1 if the algebraic is linear for the variable, and a 0 if 
not. 




(Although this equation yields a linear equation when factored, LININ 
tests the equation as described above.) 
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LIST 


LIST-* 

List to Stack Command: Takes a list of n objects and returns them 

to separate levels, and returns the total number of objects to level 1. 


Level 1 

-> Level n+1 ... 

Level 2 Level 1 

{ obj 1 ... obj„ } 

■+ obj 1 ,.. 

ObJn n 


Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: The command OBJ—* also provides this function. LIST 
is included for compatibility with the HP 28S. 

Related Commands: ARRY-+, DTAG, EQ^, ^LIST, OBJ^, 
STR—► 


—>LIST 

Stack to List Command: Takes n objects from level n+1 through 

level 2 and returns a list of those n objects. 

Level n+1 .. Level 2 Level 1 Level 1 

obj * * * objfy n —¥ ^ obj 1 P . obj ^ I 


Keyboard Access: (prg 


■:'r. ivt'v/i™"-: 


Affected by Flags: None 

Example: The program 


■*: DEPTH —TIST 


S T Ci 



combines the entire contents of the stack into a list that is stored in 
variable A. 
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—►LIST 

Related Commands: —► ARRY, LIST->, —>STR, -+TAG, -+UNIT 


ZLIST 

List Sum Command: Returns the sum of the elements in a list. 


Level 1 

-> Level t 


{ list } 

-+ sum 



Keyboard Access: 



■ ■■rrHr-BBaar ■{(■■if b a Wi u ■ aMj# ■ 1 " ■ 

BBBB (lllflPBB f M - BH ■ | J - J iff “B BB B B B 

..... »-_ - 

. n . r n r . - ■) ■> ■ ■ flH a i i. fk. 

. ... B .... . ■- . «. B ■ TtBjK B - B B B . B B 

■ ■ p I I ■ ~ ■ F ■ - * ■ p r I ff* ■> ff ll'ff ■■■■!?■ 

■■ =" “™■ ■ n—■■■■■■ 



Affected by Flags: None 

Remarks: The elements in the list must be suitable for mutual 
addition. 


Examples: -£ 5 8 S > EL I ST returns 15. 
■C R B C 1 > EL I ST returns 'fl+B+C+1 

Related Commands: IILIST, STREAM 


aLIST 

List Differences Command: Returns the first differences of the 

elements in a list. 


Level 1 

-> Level 1 

{ list } 

■+ { differences } 


Keyboard Access: (mth! 
Affected by Flags: None 
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iilist 

Remarks: Adjacent elements in the list must be suitable for mutual 
subtraction. 

Examples: £ 4 28 1 17 68 91 > I ST returns £ 16 -19 16 43 
31 >. 


£ R 6 C 1 2 3 > &L I ST returns £ 1 B-R' 1 C-B 


i i \ 


l-C 1 1 


1 fl+3 1 "A/’S' 1 Y4 1 > ALIST 


'X/5-<fl+3> ' 1 Y■'''4-X/5 


I \ 

j . 


Related Commands: ELIST, IILIST, STREAM 


nLIST 

List Product Command: Returns the product of the elements in a 
list. 


Level 1 


Level 1 


{ list } 


product 



Keyboard Access: (prg! 1118111BH 

.. 

Affected by Flags: None 

Remarks: The elements in the list must be suitable for mutual 
multiplication. 

Examples: £ 5 3 2 > 1FLIST returns 88. 

£ R B 0 1 > 1TLIST returns 1 ft*B*C 1 . 

Related Commands: ELIST ALIST, STREAM 
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LN 


Natural Logarithm Analytic Function: 

Returns the natural (base e) 

logarithm of the argument. 



{} 

Level 1 -> 

Level 1 

Z —► 

In z 

1 symb 1 —* 

'L Hisymb) 1 


Keyboard Access: ® (DQ 

Affected by Flags: Principal Solution (—1), Numerical Results (—3), 
Infinite Result Exception (—22) 

Remarks: For x—0 or (0, 0), an Infinite Result exception 
occurs, or, if flag —22 is set, —MAXR is returned. 

The inverse of EXP is a relation , not a function, since EXP sends 
more than one argument to the same result. The inverse relation for 
EXP is expressed by ISOL as the general solution 


£ 




£*ir*i*ril 


I 


The function LN is the inverse of a part of EXP, a part defined by 
restricting the domain of EXP such that 1) each argument is sent to 
a distinct result, and 2) each possible result is achieved. The points 
in this restricted domain of EXP are called the principal values of the 
inverse relation. LN in its entirety is called the principal branch of the 
inverse relation, and the points sent by LN to the boundary of the 
restricted domain of EXP form the branch cuts of LN. 

The principal branch used by the HP 48 for LN was chosen because 
it is analytic in the regions where the arguments of the real-valued 
inverse function are defined. The branch cut for the comp lex-valued 
natural log function occurs where the corresponding real-valued 
function is undefined. The principal branch also preserves most of the 
important symmetries. 

The graphs below show the domain and range of LN. The graph of the 
domain shows where the branch cut occurs: the heavy solid line marks 
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one side of the cut, while the feathered lines mark the other side of 
the cut. The graph of the range shows where each side of the cut is 
mapped under the function. 


These graphs show the inverse relation 1 LN<Z)+2*Tr*i*nl 1 for the 
case nl — 0. For other values of nl , the horizontal band in the lower 
graph is translated up (for nl positive) or down (for nl negative). 
Taken together, the bands cover the whole complex plane, which is the 
domain of EXP. 


You can view these graphs with domain and range reversed to see how 
the domain of EXP is restricted to make an inverse function possible. 
Consider the vertical band in the lower graph as the restricted domain 
Z = < Xn y '.K EXP sends this domain onto the whole complex plane in 
the range W = (.u? v) = EXP (x ? y > in the upper graph. 

Related Commands: ALOG, EXP, ISOL, LNP1, LOG 
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LNP1 

Natural Log of x Plus 1 Analytic Function: Returns In (z + l). 


{} 


Level 1 

- 

Level 1 


X 

- 

ln(x+l) 


’sy/T?/?' 

- 

'LNPl (symb)' 



Keyboard Access: 




fNXTl 


Affected by Flags: Numerical Results (“3), Infinite Result 
Exception (—22) 


Remarks: For values of x close to zero, 1 LMP1 ' returns a more 
accurate result than does 1 LN( z + 1) '. Using LNP1 allows both the 
argument and the result to be near zero, and it avoids an intermediate 
result near 1. The calculator can express numbers within 10“ 449 of 
zero, but within only 10“ 11 of 1. 


For values of x < —1, an Undef ined Result error results. For 
——1, an Infinite Result exception occurs, or, if flag —22 is set 


x 


LNP1 returns —MAXR. 


Related Commands: EXPM, LN 


LOG 


Common Logarithm Analytic Function: Returns the common 

logarithm (base 10) of the argument. 
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Level 1 

■+ Level 1 

- 

Z 

■+ log Z 


'sym/?' 

-+ 'LOG(symP)' 



Keyboard Access: fr»)(LOG) 

Affected by Flags: Principal Solution (—1), Numerical Results (—3), 
Infinite Result Exception (—22) 

Remarks: For <r=0 or (0, 0), an Infinite Result exception 
occurs, or, if flag —22 is set (no error), LOG returns — MAXR. 

The inverse of ALOG is a relation , not a function, since ALOG sends 
more than one argument to the same result. The inverse relation for 
ALOG is expressed by ISOL as the general solution 


LOG < Z > i *n i 2 „ 38258509299 1 


The function LOG is the inverse of a part of ALOG, a part defined by 
restricting the domain of ALOG such that 1) each argument is sent to 
a distinct result, and 2) each possible result is achieved. The points in 
this restricted domain of ALOG are called the principal values of the 
inverse relation. LOG in its entirety is called the principal branch of 
the inverse relation, and the points sent by LOG to the boundary of 
the restricted domain of ALOG form the branch cuts of LOG. 


The principal branch used by the HP 48 for LOG(z) was chosen 
because it is analytic in the regions where the arguments of 
the real-valued function are defined. The branch cut for the 
complex-valued LOG function occurs where the corresponding 
real-valued function is undefined. The principal branch also preserves 
most of the important symmetries. 

You can determine the graph for LOG(z) from the graph for LN (see 
LN) and the relationship log z = In z / In 10. 

Related Commands: ALOG, EXP, ISOL, LN 
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LOGFIT 


Logarithmic Curve Fit Command: Stores LOGFIT as the fifth 

parameter in the reserved variable SPAR, indicating that subsequent 
executions of LR are to use the logarithmic curve-fitting model. 


Keyboard Access: 


S)(STAT) 






mrnmm- 


rMfH ■■ ‘BG 



Affected by Flags: None 


Remarks: LINFIT is the default specification in SPAR. For a 
description of SPAR, see appendix D, “Reserved Variables.” 

Related Commands: BESTFIT, EXPFIT, LINFIT, LR, PWRFIT 


LQ 

LQ Factorization of a Matrix Command: Returns the LQ 

factorization of an nxm matrix. 


{} 


Level 1 

- Level 3 

Level 2 

Level 1 

[[ matrix ]] A 

-4 [[ matrix ]] L 

[[ matrix ]] p 

[[ matrix ]] p 


Keyboard Access: imth) liilill Biiillf 

. . . i. I . . . I ■ 3 3 




.1 


Affected by Flags: None 

Remarks: LQ factors an mxn matrix A into three matrices 


m L is a lower m x n trapezoidal matrix. 

■ Q is an n x n orthogonal matrix. 

■ P is a m x m permutation matrix. 

Where PxA = LxQ . 

Related Commands: LSQ, QR 
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LR 

Linear Regression Command: Uses the currently selected statistical 

model to calculate the linear regression coefficients (intercept and 
slope) for the selected dependent and independent variables in the 
current statistics matrix (reserved variable SDAT). 


Level 1 

■. Level 2 

Level 1 

— 

Intercept: x x 

Slope: x 2 


Keyboard Access: 


S)(sw) EEiflll 



Affected by Flags: None 


Remarks: The columns of independent and dependent data are 
specified by the first two elements in the reserved variable S PAR ^ set 
by XCOL and YCOL, respectively. (The default independent and 
dependent columns are 1 and 2.) The selected statistical model is the 
fifth element in SPAR. LR stores the intercept and slope (untagged) 
as the third and fourth elements, respectively, in SPAR . 


The coefficients of the exponential (EXPFIT), logarithmic (LOGFIT), 
and power (PWRFIT) models are calculated using transformations 
that allow the data to be fitted by standard linear regression. The 
equations for these transformations appear in the table below, where b 
is the intercept and m is the slope. The logarithmic model requires 
positive x- values (XCOL), the exponential model requires positive 
^-values (YCOL), and the power model requires positive x- and 
values. 

For a description of SPAR, see appendix D, “Reserved Variables.” 


Transformation Equations 


Model 

Transformation 

Logarithmic 

Exponential 

Power 

y b + m ln(z) 

In (y) = 1 n(i) + mx 

ln(jf) — ln(6) + m ln(x) 
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LR 

Related Commands: BESTFIT, COLE, CORR, COV, EXPFIT, 
ELINE, LINFIT, LOGFIT, PREDX, PREDY, PWRFIT, XCOL. 
YCOL 


LSQ 

Least Squares Solution Command: Returns the minimum norm 

least squares solution to any system of linear equations where 

A x X = B. 


{} 


Level 2 

Level 1 —+ 

Level 1 

[ array ] B 

[[ matrix ]] A — 

[ array ] x 

[[ matrix ]] B 

[[ matrix ]] A -+ 

[[ matrix ]] x 


Keyboard Access: 


S) (SOLVE) 





Affected by Flags: Singular Values (—54) 


Remarks: If B is a vector, the resulting vector has a minimum 
Euclidean norm \\X\\ over all vector solutions that minimize the 
residual Euclidean norm ||A x X — B ||. If B is a matrix, each column 

of the resulting matrix, X l: has a minimum Euclidean norm ||Xj|| 
over all vector solutions that minimize the residual Euclidean norm 

\\A x Xi — Bi \|. 

If A has less than full row rank (the system of equations is 
underdetermined), an infinite number of solutions exist. LSQ returns 
the solution with the minimum Euclidean length. 


If A has less than full column rank (the system of equations is 
overdetermined), a solution that satisfies all the equations may not 
exist. LSQ returns the solution with the minimum residuals of 


AxX-B. 


Related Commands: LQ, RANK, QR, / 
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LU 

LU Decomposition of a Square Matrix Command: Returns the LU 

decomposition of a square matrix. 


{} 


Level 1 - 

Level 3 

Level 2 

Level 1 

[[ matrix ]] A —i 

► [[matrix]] L 

[[ matrix ]] y 

[[ matrix ]] p 


Keyboard Access: imth) IIBII 

---ir—i- i--- 1 ttt+ 11' p>ip ■ p b---- -*■- 


Affected by Flags: None 



Remarks: When solving an exactly determined system of equations, 
inverting a square matrix, or computing the determinant of a matrix, 
the HP 48 factors a square matrix into its Grout LU decomposition 
using partial pivoting. 


The Grout LU decomposition of A is a lower-triangular matrix T, 
an up per-triangular matrix U with ones on its diagonal, and a 
permutation matrix P, such that PxA — LxU. The results satisfy 

PxA = LxU . 


Related Commands: DET INV, LSQ, / 


MANT 

Mantissa Function: Returns the mantissa of the argument. 


{} 


Level 1 


Level 1 


m a n t 


'symb' 


‘MANT(s ymb)‘ 


Keyboard Access: [mthi r e fit?; [nxtI lift N T 

RF ^ i - ii i ■ ■ i 
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MANT 

Affected by Flags: Numerical Results (—3) 
Example: -i B 2E34 MFlHT returns i„2. 

Related Commands: SIGN, XPON 


t MATCH 

Bottom-Up Match and Replace Command: Rewrites an expression. 


Level 2 

Level 1 

— Level 2 

Level 1 

'symfc-L 1 

{ 1 symb pat ' 'symb repl ' } 

—► l symb 2 1 

0/1 

'symV { 'symb pat ' 'symb repi ' 'symb cond ' } 

-+ l symb 2 1 

0/1 


Keyboard Access: H-Df symbolic] (nxt) §i|If 


Affected by Flags: None 


Remarks: jMATCH rewrites expressions or subexpressions that 
match a specified pattern 1 symb pat '. An optional condition, 

1 symb cond 1 j can further restrict whether a rewrite occurs. A test 
result is also returned to indicate if command execution produced a 
rewrite; 1 if it did, 0 if it did not. 


The pattern 1 symb 


and replacement 1 symb r 


can be normal 


with 


i. a y ubu f g p | 

expressions; for example, you can replace 1 SI N< it6 > 

1 1 .•••'£'. You can also use a “wildcard” in the pattern (to match any 
subexpression) and in the replacement (to represent that expression). 
A wildcard is a name that begins with &, such as the name 1 &H *, 
used in replacing 1 SIN<£-:FHn) ' with '-SIN(&R> 



occurrences of a particular wildcard in a pattern must match identical 
subexpressions. 


[MATCH works from bottom up; that is, it checks the lowest level 
(most deeply nested) subexpressions first. This approach works well 
for simplification. A subexpression simplified during one execution of 
fMATCH will be a simpler argument of its parent expression, so the 
parent expression can be simplified by another execution of tMATCH. 
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|MATCH 

Several subexpressions can be simplified by one execution of fMATCH 
provided none is a subexpression of any other. 

Examples: This sequence: 


SIN < TT / 6 ) 


31N ( tt 6 > 1 1 f 2 1 y -t- M RICH 


returns ! l/£ 1 to level 2 and 1 (indicating a replacement was made) 
to level 1. 


This sequence: 


I i 


SINCX+ifV t 1 SIN< &fl+TT) 


1 t 


SINt&fl) 


t-MRTCH 


returns ' -SINOO 1 to level 2 and i to level 1. 


This sequence: 

, N+4’<SQ<5)> 


ftSQ&R)> 1 1 &fi 


I I O 


y tMRTCH 


returns 1 U+5 1 to level 2 and i to level 1. 

Related Commands: J MATCH 


| MATCH 

Match Pattern Down Command: Rewrites an expression. 


Level 2 

Level 1 

■+ Level 2 

Level 1 

'sym^ 1 

{ 'sy^pat' ‘sy^repi’ } 

+ 1 symb 7 1 

0/1 

l symb 1 1 

{ 'symfpat' 'syro*repl' ‘ s ->" nb cond ’ > “ 

- l symb 2 1 

0/1 


Keyboard Access: (^[symbolic! [nxt) 
Affected by Flags: None 



Remarks: .[MATCH rewrites expressions or subexpressions that 
match a specified pattern 1 symb pat 1 . An optional condition, 

' symb con6 1 , can further restrict whether a rewrite occurs. A test 
result is also returned to indicate if command execution produced a 
rewrite; 1 if it did, © if it did not. 
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| MATCH 


The pattern 


and replacement 1 symb 


repl 


can be normal 


5 with 


SIN C u / 6 ' >. You 


'symb p a t' 

expressions; for example, you can replace 
can also use a “wildcard” in the pattern (to match any subexpression) 
and in the replacement (to represent that expression). A wildcard is a 
name that begins with such as the name 1 1 . used in replacing 

1 s i n < m+m > 1 with ■ s i h (m > *cos<&e >+cos c m > *s i n < &b > 3 . 


Multiple occurrences of a particular wildcard in a pattern must match 
identical subexpressions. 


|MATCH works from top down; that is, it checks the entire expression 
first. This approach works well for expansion. An expression 
expanded during one execution of jMATCH will contain additional 
subexpressions, and those subexpressions can be expanded by another 
execution of jMATCH. Several expressions can be expanded by one 
execution of (MATCH provided none is a subexpression of any other. 


Examples: 


, i ‘s 




1 SIHit ■■■'6) 1 } 4-riRTCH 


returns 1 SIN < tt6 > 1 to level 2 and 1 to level 1. 


i C 


SIN(U+V > 1 


I i* 



< Sxfl+ScB > 


'SIN<>*C03<&B) +COS<&fi) *S IN<> ' > +MRTCH 
returns ' SIN < U > *COS (V 5 +COS<U>*S IN < V > 1 to level 2 and 1 to 

level 1. 


This sequence: 

' SIN < 5 * Z > 


i y 


SIN<&fl+&B> 


<K=0,8«fl.COMB< 


UUSt&B'H&H— 


: fi, k>*sihc:k*tt>* 
IN ( & B )K ) 1 


1 BBS C IP < 8,R > > ==8cR 1 J +MRTCH 


returns 


1 2 < K=0, 






*8IN(K*tiY*C0 



to level 2 and 1 to level 1. 


Related Commands: | MATCH 
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MAX 

Maximum Function: Returns the greater (more positive) of the 
arguments. 


Level 2 


Level 1 


Level 1 


{} 


1 symb ' 

1 symb x ' 
x_ unit t 


'symb 


1 sym b 2 

y._ unit 2 


max(x r y) 
'MAX(x, symb) 1 
'MAX(symb f x) 1 
5 M AX( symb x , symb 2 ) 8 
max( X-unit x , y_ unit?) 


Keyboard Access: (mth 


■*- j i i-1 - - - i 


I't 




Affected by Flags: Numerical Results (—3) 
Examples: 10 “23 MAX returns 10. 

“10 "23 MAX returns “10. 
ijft 9_cro MAX returns l_n. 

Related Commands: MIN 


MAXR 

Maximum Real Function: Returns the symbolic constant 1 MflXR 1 or 

its numerical representation, 9.99999999999E499. 


Level 1 


Level 1 


'MAXR 1 

9.99999999999E499 


Keyboard Access: (mthi (nxt 


mm 


.Lv r 


NXT 


-j-.-.' avj™iv. 
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Affected by Flags: Symbolic Constants (—2), Numerical Results 

(- 3 ) 

MAXR returns its numerical representation if flag —2 or —3 is set: 
otherwise* it returns its symbolic representation. 

Remarks: MAXR is the largest numerical value that can be 
represented by the HP 48. 

Related Commands: e, i, MINR, w 


MAXI 

Maximum Sigma Command: Finds the maximum coordinate value 

in each of the m columns of the current statistics matrix (reserved 
variable ED AT). 


Level 1 



Level 1 

*Vn a x 

[ X maxl X max2 X maxm] 


Keyboard Access: l+TIfSTATi 




i ■ r r i !■ i r i i 
►rrrrrrBrrr 


v. S.-.V 



Affected by Flags: None 


Remarks: The maxima are returned as a vector of m real numbers, 

or as a single real number if m = 1. 


Related Commands: BINS, MEAN, MINX, SDEV, TOT, VAR 
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MEAN 


MCALC 

Make Calculated Value Command: Designates a variable as a 

calculated value (not user-defined) for the Multiple-Equation Solver. 


Level 1 

■+ Level 1 


'name* 



{ list } 



" ALL” 




Keyboard Access: f^rffEQ lib) 



'iW- 


Affected by Flags: None 



Remarks: MCALC designates a single variable, a list of variables, or 
all variables as calculated values. 


Related Commands: MUSER 


MEAN 

Mean Command: Returns the mean of each of the m columns of 

coordinate values in the current statistics matrix (reserved variable 

SDAT). 


Level 1 


Level 1 


- 

x m ea n 



! -^meanl x m ea n 2 ea n m ] 


Keyboard Access: 


f«-TlfSTATl f* 5 ® 



Affected by Flags: None 
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Remarks: The mean is returned as a vector of m real numbers, or 
as a single real number if m = 1. The mean is computed from the 
formula: 



where Xj is the i th coordinate value in a column, and n is the number 
of data points. 


Related Commands: BINS, MAXE, MINE, SDEV, TOT, VAR 


MEM 


Memory Available Command: 

available RAM. 

Returns the number of bytes of 

Level 1 

Level 1 

—»■ X 


Keyboard Access: f^Df memory) jlilll 


Affected by Flags: None 


Remarks: The number returned is only a rough indicator of usable 
available memory, since recovery features (LASTARG, (r*)fUNDO] , and 
[r* IfCMD 1 ) consume or release varying amounts of memory with each 
operation. 


Before it can assess the amount of memory available, MEM must 
remove objects in temporary memory that are no longer being used. 
This clean-up process (also called “garbage collection”) also occurs 
automatically at other times when memory is full. Since this process 
can slow down calculator operation at undesired times, you can force 
it to occur at a desired time by executing MEM. In a program, execute 



Related Commands: BYTES 
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MENU 


MENU 

Display Menu Command: Displays a built-in menu or a library 

menu, or defines and displays a custom menu. 


! 

Level 1 

- 

Level 1 


*m en u 

- 



{ ^definition J 

- 



'"^definition' 




obj 

* - ± 




Affected by Flags: None 

Remarks: A built-in menu is specified by a real number £ m enu- The 
format of x men u is mm.pp , where mm is the menu number and pp 
is the page of the menu. If pp doesn’t correspond to a page of the 
specified menu, the first page is displayed. The following table lists the 
HP 48 built-in menus and the corresponding menu numbers. 


Menu 

# 

Menu Name 

15 

MTH BASE 

16 

MTH BASE LOGIC 

17 

MTH BASE BIT 

18 

MATH BASE BYTE 

19 

MTH FFT 

20 

MTH CMPL 

21 

MTH CONS 

22 

PRG 

23 

PRG BRCH 1 

24 

PRG BRCH IF 

25 

PRG BRCH CASE 

26 

PRG BRCH START 

27 

PRG BRCH FOR 

28 

EDIT 

29 

PRG BRCH DO 


Menu 

# 

Menu Name 

o ; 

Last Menu 

i 

CST 

2 

VAR 

3 

MTH 

4 

MTH VECTR 

5 

MTH MATR 

6 

MTH MATR MAKE 

7 

MTH MATR NORM 

8 ' 

MTH MATR FACTR 1 

9 

MTH MATR COL 

10 

MTH MATR ROW 

11 

MTH LIST 

12 

MTH HYP 

13 

MTH PROB 

14 

MTH REAL 


Command Reference 3-187 


































































Menu 

# 

Menu Name 

62 

CHARS 

63 

MODES 

64 

MODES FMT 

65 

MODES ANGL 

66 

MODES FLAG 

67 

MODES KEYS 

68 

MODES MENU 

69 

MODES MISC 

70 

MEMORY 

71 

MEMORY DIR 

72 

MEMORY ARITH 

73 

STACK 

74 

SOLVE 

75 

SOLVE ROOT 

76 

SOLVE DIFFE 

77 

SOLVE POLY 

78 

SOLVE SYS 

79 

SOLVE TVM 

80 

SOLVE TVM SOLVR 

81 

PLOT 

82 

PLOT PTYPE 

83 

PLOT PPAR 

84 

PLOT 3D 

85 

PLOT 3D PTYPE 

86 

PLOT 3D VPAR 

87 

PLOT STAT 

88 

PLOT STAT PTYPE 

89 

PLOT STAT SPAR 

90 

PLOT STAT SPAR MODL 

91 

PLOT STAT DATA 

92 

PLOT FLAG 

93 

SYMBOLIC 


Menu 

# 

Menu Name 

30 

SOLVE ROOT SOLVR 

31 

PRG BRCH WHILE 

32 

PRO TEST 

33 

PRG TYPE 

34 

PRG LIST 

35 

PRG LIST ELEM 

36 

PRG LIST PROC 

37 

PRG GROB 

38 

PRG PICT 

39 

PRG IN 

40 

PRG OUT 

41 

PRG RUN 

42 

UNITS (Units Catalog Menu) 

43 

UNITS LENG 

44 

UNITS AREA 

45 

UNITS VOL 

46 

UNITS TIME 

47 

UNITS SPEED 

48 

UNITS MASS 

49 

UNITS FORCE 

50 

UNITS ENRG 

51 

UNITS POWR 

52 

r 

UNITS PRESS 

53 

UNITS TEMP 

54 

UNITS ELEC 

55 

UNITS ANGL 

56 

UNITS LIGHT 

57 

UNITS RAD 

58 

UNITS VISC 

59 

UNITS 

60 

PRG ERROR IFERR 

61 

PRG ERROR 
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MENU 


Menu 

# 

Menu Name 

107 

IO PRINT 

108 

IO PRINT PRTPA 

109 

IO SERIA 

110 

LIBRARY 

111 

LIBRARY PORTS 

112 

LIBRARY PORTS :0: 

113 

EQ LIB 

114 

EQ LIB EQLIB 

115 

EQ LIB COLIB 

116 

EQ LIB MES 

117 

EQ LIB UTILS 



Menu 

# 

Menu Name 

94 

TIME 

95 

TIME ALARM 

: 96 

STAT 

97 

! STAT DATA 

98 

STAT EPAR 

99 

STAT EPAR MODL 

100 

STAT 1VAR 

101 

STAT PLOT 

102 

STAT FIT 

103 

STAT SUMS 

104 

IO 

105 

IO SRVR 

106 

IO IOPAR 


Library menus are specified in the same way as built-in menus, with 
the library number serving as the menu number. 

Custom menus are specified by a list of the form 
C 11 label-object n action-object > (see appendix D, “Reserved 
Variables/ 7 for details) or a name containing a list nitjon ') 

Either argument is stored in reserved variable CST y and the custom 
menu is subsequently displayed. 

MENU takes any object as a valid argument and stores it in CST. 
However, the calculator can build a custom menu only if CST 
contains a list or a name containing a list. Thus, if an object other 
than a list or name containing a list is supplied to MENU, a Bad 
flrgunent Type error will occur when the calculator attempts to 
display the custom menu. 

Examples: 5 MENU displays the first page of the MTH MATE 
NORM menu. 


4h„ 02 MENU displays the second page of the UNITS MASS menu. 



argument. 


MENU displays the custom menu defined by the list 


1 MYMENU 1 MENU displays the custom menu defined by the name 
argument. 
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MENU 

Related Commands: RCLMENU, TMENU 


MERGE 

Merge RAM Card Command: Merges the RAM from the card in 

port 1 with the rest of main user memory. Merged memory is no 
longer independent. 


Level 1 

- 

Level 1 

1 

- 



Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: MERGE is provided for compatibility with the HP 48S 
series. See MERGE 1. 

Related Commands: FREEl, MERGE1 


MERGE1 


Merge RAM Card Command: Merges the RAM from the card in 

port 1 with the rest of main user memory. Merged memory is no 
longer independent. 


Keyboard Access: ^(library) lllJil 


Affected by Flags: None 


Remarks: If the RAM card contains library or backup objects, they 
are moved to port 0 before the RAM is merged. Library and backup 
objects can exist only in independent memory (port 1 through 33 
unmerged, or port 0). 


Cards larger than 128K cannot be merged, and cannot be plugged into 
port 1. 
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MIN 


Related Commands: FREE. FREE1, MERGE 


MIN 

Minimum Function: Returns the lesser (more negative) of its two 
arguments. 


{} 


Level 2 

Level 1 

- 

Level 1 

h ■ - 

X 

y 

- 

min(x f y) 

X 

' symb 1 

- 

’MIN(x, symb)' 

'symb 1 

X 


'MIN(symb, x)‘ 

'symb x 1 

' symb 2 ' 

- 

'MIN (symb x , symb 2 )' 

x_ unit 1 

y_ unity 

- 

min( x„unit x , y_ unity) 


Keyboard Access: 



Affected by Flags: Numerical Results (—3) 


Examples: 10 £3 MIN returns 10. 



-23 MIN returns 




1 _m 9MIN returns 9_cr*i. 

Related Commands: MAX 
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MINEHUNT 


MINEHUNT Game Command: Starts the MINEHUNT game 


Keyboard Access: R-THeq lib) rauiS 


Affected by Flags: None 



Remarks: In the game, you are standing in the upper-left corner 
of an 8 x 16 battlefield grid. Your mission is to travel safely to the 
lower-right corner, avoiding invisible mines along the way. The game 
tells you how many mines are under the eight squares adjacent to your 
position. 



NEAR 0 MINES SCORE: 1 
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Use the number or arrow keys to cross the battlefield one square at a 
time. (Use (7), ( 9 ), (T), and QQ to move diagonally.) You can exit the 
game any time by pressing (CANCEL) . 

To interrupt and save a game, press [STQj . Phis creates a variable 
MHpar in the current directory and ends the game. If MHpar exists 
when you next start Minehunt, the interrupted game resumes and 
MHpar is purged. 

You can change the number of mines in the battlefield by creating a 
variable named Nmines containing the desired number. Nmines must 
contain a real number (1 to 64). If Nmines is negative, the mines are 
visible during the game. 
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MINR 




Multiple Equation Menu Initialization Command: Creates the 

reserved variable Mpar. 


Keyboard Access: 


f+HtEQ LIB | 



Affected by Flags: None 


Remarks: MINIT takes multiple equations stored in EQ and creates 
the multiple equation reserved variable Mpar. See appendix D, 
Reserved Variables,” for information about Mpar. 


Related Commands: MITM, MROOT, MSOLVR 


MINR 

Minimum Real Function: Returns the symbolic constant ' MINR 1 or 
its numerical representation, 1.00000000000E-499. 


Level 1 

- 

Level 1 


— ► 

‘MINR’ 



1.00000000Q00E—499 


Keyboard Access: ( mth ) flxT) 18*111 (nxT)I liiS* 


Affected by Flags: Symbolic Constants (—2), Numerical Results 

(- 3 ) 


MAXR returns its numerical representation if flag —2 or —3 is set: 
otherwise, it returns its symbolic representation. 

Remarks: MINR is the smallest nonzero numerical value that can be 
represented by the HP 48. 


Related Commands: e, i, MAXR, % 


Command Reference 3-193 


































MINI 

Minimum Sigma Command: Finds the minimum coordinate value 

in each of the m columns of the current statistics matrix (reserved 
variable EDAT). 


Level 1 


Level 1 




m t n 


t i n 1 *m i n 2 


minm 


] 


Keyboard Access: («t 1 f stat ] fi VflR ! !i I NS 

^ . .. ' ... 

Affected by Flags: None 

Remarks: The minima are returned as a vector of m real numbers, 
or as a single real number if m = 1. 

Related Commands: BINS, MAXE, MEAN, SDEV, TOT, VAR 


MITM 

Multiple Equation Menu Item Order Command: Changes multiple 

equation menu titles and order. 


Level 2 

Level 1 

Level 1 


” tit Id' 

{ list } 




Keyboard Access 


f^llEQ LIB| 



• *t p n ■ * i r r r h p r*i __ _ 

« L ' r 1 ■ : L « i r * p i r r r i p *• r IT A i I i - p >1 r p r p r ■ r p I. 1 

*,VArttk. va v. 1,1 ” ■ i 

. p ■ . r I . i i I . » . I- r p • • • 

■ i • •Mflp'rr nir 

■"lllfMHHtfH p fc p * • ■ p • 

- . t ■ r i- I-t-I- i -I-I- i-i> pi- • p t t i 


Affected by Flags: None 

Remarks: list contains the variable names in the order you want. 

Use 11 “ to indicate a blank label. You must include all variables in the 
original menu and no others. 
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Related Commands: MINIT 


MOD 

Modulo Function: Returns a remainder defined by: 

x mod y = x — y floor (x/y) 


{} 


Level 2 

Level 1 

+ Level 1 

X 

y 

■+ x mod y 

X 

1 sym b' 

+ MOD(x, symb) 

' symb 1 

X 

+ 'MOD(symf>, x)' 

1 symb x 1 

1 symb 2 1 

+ l U\OD(symb l r symb 2 V 


Keyboard Access: mthi isstaii mamm 

» . . . 

Affected by Flags: Numerical Results (—3) 

Remarks: Mod (x, y) is periodic in x with period y. Mod (x } y) lies 
in the interval [0, y) for y > 0 and in (#, 0] for y < 0. 

Related Commands: FLOOR, / 


MROOT 

Multiple Roots Command: Uses the Multiple-Equation Solver to 
solve for one or more variables using the equation set in Mpar. 


Level 1 


‘name 1 

"ALL” 


{} 


Level 1 
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MROOT 


Keyboard Access: 


(♦illEQ LIBJ HEU 


Affected by Flags: None 



Remarks. Solves for one or more variables starting with only 
user-defined values, and leaves found values in the variables. No status 
messages are displayed. Given a variable name, MROOT returns the 
found value; it can also take "hLL" (stores a found value for each 
variable) and return nothing to the stack. 

Related Commands: MCALC, MUSER 


MSGBOX 

Message Box Command: Creates a user-defined message box. 



Level 1 


" message " 



Level 1 


Keyboard Access: 


fPRGlfNXTl 



Affected by Flags: None 


Remarks: MSGBOX displays "message " in the form of a standard 
message box. Message text longer than 75 characters (including 

spaces) is truncated to 75 characters. You can use spaces and new-line 
characters ((x3G^3) **° con trol word-wrapping and line breaks within 

the message. 


Program execution resumes when the message box is exited by 

* 4 1. Ill - V -- _-!* ■ ■- LLU ■ ■ u 

1 J V, r ■- - | ■ r'. -.-.V.V.V, I "* I I I '" 

selecting or ilSiliftfc- 


Related Commands: CHOOSE, INFORM, PROMPT 
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MUSER 


MSOLVR 


Multiple-Equation Solver Command: Gets the Multiple-Equation 

Solver variable menu for the set of equations defined by Mpar. 

Keyboard Access: 



Affected by Flags: None 

Remarks: The Multiple-Equation Solver application can solve a set 
of two or more equations for unknown variables by finding the roots of 
each equation, one at a time. 


The Multiple-Equation Solver uses the list of equations stored in 
EQ. "Equations” in this context includes programs, expressions, and 
variable names that evaluate to a single value. The Multiple-Equation 
Solver requires that EQ contain more than one equation—that is, 


the HP Solve application would include the 



menu label for 


EQ. The solver uses EQ to create a reserved variable Mpar that is 
used during the solution process. Mpar contains the equation set plus 
additional information. See appendix D, “Reserved Variables,” for 
information about Mpar. 


Related Commands: EQNLIB, SOLVEQN 


MUSER 

Make User-Defined Variable Command: Designates a variable as 

user-defined for the Multiple-Equation Solver. 

Level 1 -► Level 1 

' name ’ —> 

{ list } ~h 

"ALL" 
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fin 


MUSER 

Keyboard Access: f+Tl(EQ lib] 

Affected by Flags: None 

Remarks: MUSER designates a single variable, a list of variables, or 
all variables as user-defined. 


Related Commands: MCALC 


NDIST 

Normal Distribution Command: Returns the normal probability 

distribution (bell curve) at x based on the mean m and variance v of 
the normal distribution. 


{} 


Level 3 

Level 2 

Level 1 

^ Level 1 

m 

V 

X 

-+ ndist(m,v,x) 


Keyboard Access: imth! [nxt! UlBBi InxtI HI 


Affected by Flags: None 


Remarks: NDIST is calcinated using this formula: 



ndist{m , v. x) = 



Related Commands: UTPN 
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NEG 


NEG 

Negate Analytic Function: Changes the sign or negates an object. 



Level 1 


Level 1 


Z 

#n 1 
[ array ] 
1 symb 1 
x_ unit 
grob 1 
P/C^ 


—z 

*n 2 

[ - array ] 
'-{symby 
-x-unit 
grob 2 

pict 2 


Keyboard Access: 


m 

(MTH1 (NXT) 





-L__.. - ------- ■ 

H.h-r'-rrh'i • i i-i - ------ i - 


Affected by Flags" Numerical Results (—3), Binary Integer Wordsize 
(-5 through -10) 

Remarks: Negating an array creates a new array containing the 
negative of each of the original elements. Negating a binary number 
takes its two s complement (complements each bit and adds 1). 

Negating a graphics object “inverts 5 ’ it (toggles each pixel from on to 
off, or vice-versa). If the argument is PICT^ the graphics object stored 
in PICT is inverted. 

Related Commands: ABS, CONJ, NOT, SIGN 
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NEWOB 

New Object Command: Creates a new copy of the specified object. 


Level 1 

obj 


Level 1 

obj 


Keyboard Access: 



Affected by Flags: Last Arguments (—55) 


In order for NEWOB to immediately release the memory occupied by 
the original copy, flag —55 must be set so that the copy is not saved as 
a last argument. 


Remarks: NEWOB has two main uses: 


■ NEWOB enables the purging of a library or backup object that has 
been recalled from a port. NEWOB creates a new, separate copy 
of the object in memory, thereby allowing the original copy to be 
purged. 

■ Creating a new copy of an object that originated in a larger 
composite object (such as a list) allows you to recover the memory 
associated with the larger object when that larger object is no 
longer needed. 


Examples: : 1 : BKUP1 ft CL NEWOB 

purges the backup object BKUP1 . 



JP1 PURGE recalls and 


3 GET NEWOB retrieves the third element out of a list in the stack, 
recovering the memory occupied by the whole list. 


Related Commands: MEM, PURGE 
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NEXT 


NEXT Command: Ends definite loop structures. 

See the FOR and START command entries for syntax information. 

Keyboard Access: 



fpRGi warn. . 




Remarks: See the FOR and START keyword entries for more 
information. 


Related Commands: FOR, START, STEP 


NEXT 


Next Operation: Returns but does not execute the next one or two 
steps of a program. 


Keyboard Access: fpR<0 f nxT) fllBIS 



Affected by Flags; None 


Related Commands: SST. SST„ 


NOT 

NOT Command: Returns the one : s complement or logical inverse of 

the argument. 
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Level 1 

#»i 

T/F 

" string 1 ” 
'symb' 


Level 1 

#«2 

0/1 

n string 2 " 

NOT symb 1 



Keyboard Access: 



Affected by Flags: Numerical Results (—3), Binary Integer Wordsize 

(—5 through —10) 

Remarks: When the argument is a binary integer or string, NOT 
complements each bit in the argument to produce the result. 

■ A binary integer is treated as a sequence of bits as long as the 
current wordsize. 

■ A string is treated as a sequence of bits, using 8 bits per character 
(that is, using the binary version of the character code). 

When the argument is a real number or symbolic, NOT does a 
true/false test. The result is 1 (true) if the argument is zero; it is 0 
(false) if the argument is nonzero. This test is usually done on a test 
result (T/F). 

If the argument is an algebraic object, then the result is an algebraic 
of the form 1 NOT symb 1 . Execute +NUM (or set flag —3 before 
executing NOT) to produce a numeric result from the algebraic result. 

Related Commands: AND, OR, XOR 
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NOVAL 

INFORM Place Holder/Result Command: Place holder for reset and 

initial values in user-defined dialog boxes. NOVAL is returned to the 
stack when a field is empty. 


Keyboard Access: [pro! [nxt! 




Affected by Flags: None 


Remarks: NOVAL is used to mark an empty field in a user-defined 
dialog box created with the INFORM command. INFORM defines 
fields sequentially. If default values are used for those fields, the 
defaults must be defined in the same order as the fields were defined. 
To skip over (not provide defaults for) some of the fields, use the 
NOVAL command. 


After INFORM terminates, NOVAL is returned to the stack (on level 
2) if a field is empty and ||||^S||1 or [ENTER! is selected. 


Related Commands: INFORM 


NSUB 


Number Of Sublist Command: Provides a way to access the current 
sublist position during an iteration of a program or command applied 
using DOSUBS. 


Keyboard Access: 


fpRGi liasi 

----- - . ■ r - - ■ - - - i ■ a ■ ■ a e ■ ■ i a I 




Affected by Flags: None 


Remarks: Returns an Undef ined Local Harie error if executed 
when DOSUBS is not active. 


Related Commands: DOSUBS, ENDSUB 
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NUM 



Character Number Command: 

Returns the character code 

n for the 

first character in the string. 


{> 

Level 1 

-+ Level 1 


" string" 

—► n 

- 


Keyboard Access: 


Q (CHARS) 


. j j i i iJ.j i 'iJiJ I I i ■* I § 


i j i i i 



■ II I ! 



7 ri 


<i n ri i I ■ I i ! - 



t-.T- 


-X 




E fNXTl NO Ml 


Affected by Flags: None 

Remarks: The character codes are an extension of ISO 8859/1. 
Codes 128 through 159 are unique to the HP 48. 


The following tables show the relation between character codes 
(results of NUM, arguments to CHR) and characters (results of CHR, 
arguments to NUM). 
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NUM 


Character Codes (0 — 127) 


NUM 

CHR 

NUM 

CHR 

NUM 

CHR 

NUM CHR 

0 

a 

32 


64 

e 

96 ‘ 

h a# - 

1 

a 

.j 

1 

■ 

65 

R 

O" 

«M| 

v 

a 

34 

u 

£ til 

oo 

B 

Cl ■! 

: ! fa 

o 

-^1 

m 

■“i CT 

■- 1 ■J 

& 

Tr 

67 

c 

99 c 

4 

m 

“i £ 

ob 

$ 

C O 
o o 

D 

100 d 

ET 1 

i 

m _■ 

a 

37 


69 

MHt 

L 

101 e 

6 

« 

HI KS ■ 

‘ i i : 

8, 

70 

F 

10 

2 f 

H 

i 

m 

39 

i 

71 

G 

16 

y q 

*W" 

o 

M 

s 

40 

c 

”7 

H 

104 h 

9 

m 

41 

> 

“7 *“i 
l" -J 

i 

10 

5 i. 

10 

m 

42 


74 

J 

106 j 

11 

■ 

a 

43 

4* 

mam ■ mi 

K 

10 

7 k 

12 

B 

*4 4 

* 

76* 

L 

10 

8 1 

13 

m 

45 

— 

m m 

i i‘ 

M 

10 

9 n 

14 

m 

46 

B 

78 

N 

11 

8 n 

15 

m 

47 


79 

0 

11 

1 o 

16 

m 

48 

8 

8 0 

p 

11 

•“I •„ 

iZ. p 

17 

« 

49 

1 

81 

Q 

11 

3 q 

CO 

m 

59 

o 

n *“i 
*^1 ^ 

R 

l i 

4 r 

19 

gas 

m 

51 

»J 

i“*a i 
; w i 

i"% 

O 

11 

H S 

20 

■ 

52 

4 

84 

T 

11 

6 t- 

21 

a 


3 

err 

!J .J 

IJ 

11 

f U 

' j ’”i 
■ ■ 

L— 1mm 

a 

54 

6 

Ml «tf 

db 

V 

li 

8 y 

- J o 

m 

MAM MH» 

lu* lm. 

“7 

i“* “7 

V 1 

14 

11 

9 w 

24 

m 

56 

i^: 

O 

f“i “i 

o o 

x 

12 

0 X 

25 

m 

57 

9 

fiQ 

O I? 

V 

1 

12 

1 y 

Im« 5 ™ S 

m 

ET i"*i 

a 

B 

90 


12 

2 z 

r 

m 

59 

b 

3 

91 

[ 

12 

3 I 

o O 

ft- 

m 

60 

< 

Qv 

N 

12 

4 1 

29 

m 

61 

” j 

QO 

17 -.j 

] 

12 

cr 

•J -« 

3 0 

m 

■*! 

\ 

W 

u. 

94 


12 

■** 

fal f V 

31 

in 

.j 

■ 

■ 

■ 

OR 

■ ■ i 


12 

sun 
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NUM 


Character Codes (128 — 255) 


NUM CHR NUM CHR NUM CHR NUM CHR 



Related Commands: CHR, POS, REPL, SIZE, SUB 
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-NUM 

Evaluate to Number Command: Evaluates a symbolic argument 

object (other than a list) and returns the numerical result. 


{} 

Level 1 

■+ Level 1 


ob h y m b 

Z 



Keyboard Access: 

Affected by Flags: None 

Remarks: —►NUM repeatedly evaluates a symbolic argument until a 
numerical result is achieved. The effect is the same as evaluating the 
symbolic argument in Numerical Result mode (flag —3 set). 

Related Commands: EVAL, SYSEVAL 


NUMX 

Number Of X-Steps Commend: Sets the number of x-steps for each 

y-step in 3D perspective plots. 


_ {> 

Level 1 ->• Level 1 


n* 


Keyboard Access: 


f^lfPLOn fNXTl 





Bil in xt 11111 11 


Affected by Flags: None 


Remarks: The number of x-steps is the number of independent 
variable points plotted for each dependent variable point plotted. 
This number must be 2 or more. This value is stored in the reserved 
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variable VPAR. YSLICE is the only 3D plot type that does not use 
this value. 

Related Commands: NUMY 


NUMY 

Number Of Y-Steps Command: Sets the number of y-steps across 

the view volume in 3D perspective plots. 



Level 1 


Level 1 



Keyboard Access: m-TUplotiinxti 


■ ■■■■■■■■■■ m i— ■! - 

■.■.y.Y.-.-.-.-.-.YiiiV': 

■a m ,i iiiLi.rT:| 1 , 
|i<r I ■ i^f f ■■ I 1 


- - ■•S 1 - -. 

I f ------ 

-up--’ ■ 1 — 


■ 11 - 1 --I -1 ■ 





[NXTl nw 

m. « ..... 


Affected by Flags: None 

Remarks: The number of y-steps is the number of dependent 
variable points plotted across the view volume. This number must be 
2 or more. This value is stored in the reserved variable VPAR. 


Related Commands: NUMX 


NZ 

Number Of Rows Command: Returns the number of rows in the 

current statistical matrix (reserved variable EDAT). 


Level 1 

- Level 1 


— 

n rows 



Keyboard Access: 


QdTAT) 
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OBJ 

Affected by Flags: None 

Related Commands: EX, EX*Y, EX~2, EY, EY 2 


OBJ^ 

Object to Stack Command: Separates an object into its components 
onto the stack. For some object types, the number of components is 
returned to level 1. 


Level 1 


Level n+1 


* t 4 


Level 2 


Level 1 


(x,y) 

{ obj-L ... obj n } 
[ *1 ■■■ x n ] 

[[ • • • ’-nr. n ]] 

"Obj" 

'symb' 
x_ unit 


obj i 


li 


arg 1 ... arg n 


obj n 


m n 


{ n } 

{mn} 

evaluated-object 
1 function 1 


1 -unit 


: tag: obj 


obj 


" tag " 


Keyboard Access: 



Affected by Flags: None 

Remarks: If the argument is a complex number, list, array, or string, 
OBJ—provides the same functions as C—►R, LIST—*, ARRY—t, and 
STR—respectively. For lists, OBJ—> also returns the number of 
list elements. If the argument is an array, OBJ—► also returns the 
dimensions { m n } of the array, where m is the number of rows and n 
is the number of columns. 

For algebraic objects, OBJ—► returns the arguments of the top-level 
(least-nested) function (arg 1 ... arg n ), the number of arguments 
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of the top-level function (n), and the name of the top-level function 
(function). 

If the argument is a string, the object sequence defined by the string is 
executed. 


Example: 

returns: 


The command sequence 1 £ < 01 


SIN < X > 


H 


V 




0 first argument 



second argument 



third argument 



*"i is 
C n 


1 


a 

u 


1 fourth argument 

4 number of arguments for f 

£ function name 


Related Commands: ARRY^, C->R, DTAG, EQ^, LIST-*, R-+C, 
STR—-*TAG 



Octal Mode Command: Selects octal base for binary integer 
operations. (The default base is decimal.) 


Keyboard Access: 





Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 

Remarks: Binary integers require the prefix #. Binary integers 
entered and returned in octal base automatically show the suffix o. If 
the current base is not octal, enter an octal number by ending it with 
o. It will be displayed in the current base when entered. 


The current base does not affect the internal representation of binary 
integers as unsigned binary numbers. 

Related Commands: BIN, DEC, HEX, RCWS, STWS 
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OFF 

Off Command: Turns off the calculator. 


Keyboard Access: ( prg ) (nxt] sBliS [nxt] 


Affected by Flags: None 



Remarks: When executed from a program, that program will 
resume execution when the calculator is turned on. This provides a 
programmable "autostart.” 

Related Commands: CONT, HALT, KILL 


OLDPRT 


Old Printer Command: Modifies the remapping string in the reserved 
variable PliTPAR so that the extended character set of the HP 48 
matches that of the HP 82240A Infrared Printer. 


Keyboard Access: 



wmm 




:l 



ill® 


Affected by Flags: None 


Remarks: The character set in the HP 82240A Infrared Printer does 
not match the HP 48 character set: 


■ 24 characters in the HP 48 character set are not available in the 
HP 82240A Infrared Printer. (From the table in the keyword listing 
for NUM, these characters are numbers 129, 130, 143-157, 159, 

166, 169, 172, 174, 184, and 185.) The HP 82240A prints a i in 
substitution. 


■ Many characters in the extended character table (character codes 
128 through 255) do not have the same character code. For 
example, the f character has code 171 in the HP 48 and code 146 in 
the HP 82240A Infrared Printer. 

To use the CHR command to print extended characters with an HP 
82240A Infrared Printer, first execute OLDPRT. The remapping string 
modified by OLDPRT is the second parameter in PRTPAR . This 
string (which is empty in the default state) changes the character code 
of each byte to match the codes in the HP 82240A Infrared Printer 
character table. 
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OLDPRT 


To cancel OLDPRT character mapping, purge the variable PRTPAR 


or enter naPRTPflRna 2 


i r 


PUT. 


To print a string containing graphics data, disable OLDPRT. 

E 

Related Commands: CR, DELAY, PRLCD, PRST, PRSTC, 
PRVAR, PR1 


OPENIO 


Open I/O Port Command: Opens the serial port or the IR port using 
the I/O parameters in the reserved variable IOPAR. 


Keyboard Access: 


S)QZ2)(nxD 




Affected by Flags: I/O Device (-33) 


Remarks: Since all HP 48 Kermit-protocol commands automatically 
effect an OPENIO first, OPENIO is not normally needed, but can be 
used if an I/O transmission does not work. OPENIO is necessary for 
interaction with devices that interpret a closed port as a break. 


OPENIO is also necessary for the automatic reception of data into 
the input buffer using non-Kermit commands. If the port is closed, 
incoming characters are ignored. If the port is open, incoming 
characters are automatically placed in the input buffer. These 
characters can be detected with BUFLEN, and can be read out of the 
input buffer using SRECV. 

If the port is already open, OPENIO does not affect the data in the 
input buffer. However, if the port is closed, executing OPENIO clears 
the data in the input buffer. 


For more information, refer to the reserved variable IOPAR in 
appendix D, “Reserved Variables.” 

Related Commands: BUFLEN, CLOSElO, SBRK, SRECV, STIME, 
XMIT 
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OR 

OR Function: Returns the logical OR of two arguments. 



Level 2 Level 1 -> Level 1 


#n 3 

"string 3 " 
0/1 


#°1 


string 1 ” 

M string 2 

T/F x 

t/f 2 

T/F 

‘symb' 

'symb' 

T/F 

sym^ ' 

'symb 2 


1 T/F OR symb' 
'symb OR T/F' 
'syrn^ OR symb 2 


Keyboard Access: 


fMTHl 111111! 1NXT1 1H111I 

L L L L L _ _ . . , . . _ ■ , , r r r 


fpRGl wmmm fNxri itiiii 

.V ',V, Va'jjV ^ j , j V-'.V.V.V.V. \' 



Affected by Flags: Numerical Results (—3), Binary Integer Wordsize 
(—5 through —10) 


Remarks: When the arguments are binary integers or strings, OR 
does a bit-by-bit (base 2) logical comparison. 

■ An argument that is a binary integer is treated as a sequence of bits 
as long as the current wordsize. Each bit in the result is determined 
by comparing the corresponding bits (bit 1 and bit 2 ) in the two 
arguments as shown in the following table. 


bit\ 

bit 2 

biti OR bit 2 

0 

0 

0 

0 

1 

1 

1 

0 

1 

1 

1 

1 


■ An argument that is a string is treated as a sequence of bits, using 8 
bits per character (that is, using the binary version of the character 
code). The two string arguments must be the same length. 
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When the arguments are real numbers or symbolics, OR simply does a 
true/false test* The result is 1 (true) if either or both arguments are 
nonzero; it is 0 (false) if both arguments are zero. This test is usually 
done to compare two test results. 

If either or both of the arguments are algebraic objects, then the result 
is an algebraic of the form ? symb 1 OR symb 2 1 . Execute 4NUM (or set 
flag —3 before executing OR) to produce a numeric result from the 
algebraic result. 

Related Commands: AND, NOT, XOR 


ORDER 

Order Variables Command: Reorders the variables in the current 

directory (shown in the VAR menu) to the order specified. 


Level 1 -► Level 1 


{ global-^ ... g(obal n } 


Keyboard Access: f+rlf memory 1 
Affected by Flags: None 


1 



Remarks: The names that appear first in the list will be the first to 
appear in the VAR menu. Variables not specified in the list are placed 
after the reordered variables. 


If the list includes the name of a large subdirectory, there may be 
insufficient memory to execute ORDER. 

Related Commands: VARS 
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PAR AMETR 1C 


OVER 

Over Command: Returns a copy to stack level 1 of the object in 
level 2. 


Level 2 

Level 1 -> 

Level 3 

Level 2 

Level 1 

obj i 

°bj 2 -+ 

obj 1 

°bj 2 

Obj-y 


Keyboard Access: Rt) f stack 1 ||i BM 

Affected by Flags: None 

Related Commands: PICK, ROLL, ROLLD, ROT, SWAP 


PARAMETRIC 

Parametric Plot Type Command: Sets the plot type to 

PARAMETRIC. 


Keyboard Access: f+iKPLOTl 


LL” rr 


vfy.iv 


,'-■.1.v 


iW 



■ flrrr-' 




ri i -Bi - fc - ■ 


ivl'f 

4 ! *!■-*-* 


I I! ! 114 ! I S 4 I MBBiii^iirr 


Affected by Flags: Simultaneous Plotting (—28), Curve Filling 
(-28) 


Remarks: When the plot type is PARAMETRIC, the DRAW 

command plots the current equation as a complex-valued function of 
one real variable. The current equation is specified in the reserved 
variable EQ. The plotting parameters are specified in the reserved 
variable PPAR , which has the following form: 


$min ? 


VminVmax> indep res axes piype depend > 


For plot type PARAMETRIC, the elements of PPAR are used as 
follows: 


■ j: -^min ? ^min i s a complex number specifying the lower left corner 
of PICT (the lower left corner of the display range). The default 
value is < “6.5? -3. 1 >. 
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PARAMETRIC 


■ (imax, fmax > is a complex number specifying the upper right 
corner of PICT (the upper right corner of the display range). The 
default value is <6-5? 3.2>. 

■ tndep is a list containing a name that specifies the independent 
variable, and two numbers specifying the minimum and maximum 
values for the independent variable (the plotting range). Note 
that the default value is X. If X is not modified and included 

in a list with a plotting range, the values in jn , y m m ) and 
<x max , i/max > are used as the plotting range, which generally leads 
to meaningless results. 

■ res is a real number specifying the interval, in user-unit coordinates, 
between values of the independent variable. The default value is 9, 
which specifies an interval equal to 1/130 of the difference between 
the maximum and minimum values in indep (the plotting range). 

■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin, a list specifying the tick-mark annotation, and two 
strings specifying labels for the horizontal and vertical axes. The 
default value is <. 9 ? 9 >. 

■ ptype is a command name specifying the plot type. Executing the 

command PARAMETRIC places the name PARAM ETRIC in 

PPAR. 

u depend is a name specifying a label for the vertical axis. The default 
value is Y. 

The contents of EQ must be an expression or program; it cannot be 
an equation. It is evaluated for each value of the independent variable. 
The results, which must be complex numbers, give the coordinates 
of the points to be plotted. Lines are drawn between plotted points 
unless flag —31 is set. 

If flag —28 is set, all equations are plotted simultaneously. 

See chapter 23 of the HP 48 User’s Guide for an example using the 
PARAMETRIC plot type. 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARSURFACE, PCONTOUR, POLAR, 
SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, YSLICE 
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PARITY 

Parity Command: Sets the parity value in the reserved variable 

10 PAR. 


{} 


Level 1 

■+ Level 1 


^parity 

- 



Keyboard Access: 


o I l i Sl Siiliia 


Affected by Flags: None 


Remarks: Legal values are shown below. A negative value means the 
HP 48 does not check parity on bytes received during Kermit transfers 
or with SRECV. Parity is still used during data transmission, however. 


n-Value 

Meaning 

0 

no parity (the default value) 

1 

odd parity 

2 

even parity 

3 

mark 

4 

space 


For more information, refer to the reserved variable 10PAR 
( I/O parameters) in appendix D, “Reserved Variables.” 

Related Commands: BAUD, CKSM, TRANSIO 
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PARSURFACE 

PARSURFACE Plot Type Command: Sets plot type to 
PARSURFACE. 


Keyboard Access: 


S)(PLOT) (NXT) 





Affected by Flags: None 


Remarks: When plot type is set to PARSURFACE, the DRAW 

command plots an image graph of a 3-vector-valued function of two 
variables. PARSURFACE requires values in the reserved variables 
EQ, VPAR , and PPAR. 

VP A R is made up of the following elements: 


^left bright 2/near 2/far Tow ^high in ^max fmin 2/max ^eye 2/eye 

"i 

/eye 2?step 2/step J 

For plot type PARSURFACE, the elements of VPAR are used as 

follows: 

■ a:| e f t and £ ri g ht are real numbers that specify the width of the view 
space. 

■ |/ ne ar and f/ far are real numbers that specify the depth of the view 
space. 

■ z ]om and z high are real numbers that specify the height of the view 
space. 

■ x m j n and £ max are real numbers the specify the input region’s 
width. The default value is 

■ 2/min and y max are real numbers that specify the input region’s 
depth. The default value is < -1 P 1 >. 

■ z eye , 2/eye, and 2 eye are real numbers that specify the point in 
space from which the graph is viewed. 

■ x step and 2/step are real numbers that set the number of 
x-coordinates versus the number of y-coordinates plotted. 

The plotting parameters are specified in the reserved variable PPAR, 

which has this form: 

•c ^ min > a x ) 2/max > mim res axes piype depend > 
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For plot type PARSURFACE, the elements of PPAR are used as 

follows: 

■ '^min t 2/m in } ls n °t used. 

■ !/max not used, 

■ indep is a name specifying the independent variable. The default 
value of indep is A. 

■ res is not used. 

■ axes is not used. 

■ ptyP e is a command name specifying the plot type. Executing the 
command PARSURFACE places the name PARSURFACE in piype . 

n depend is a name specifying the dependent variable. The default 
value is Y . 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PCONTOUR, POLAR, 

SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, YSLICE 


PATH 

Current Path Command: Returns a list specifying the path to the 

current directory. 


Level 1 -* Level 1 


{HOME directory-name-L ... directory-name n } 


Keyboard Access: 


memory) 


m 



Affected by Flags: None 


Remarks: The first directory is always HOME , and the last directory 
is always the current directory. 


If a program needs to switch to a specific directory, it can do so by 
evaluating a directory list, such as one created earlier by PATH. 
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Related Commands: CRDIR, HOME, PGDIR, UPDIR 


PCOEF 

Monic Polynomial Coefficients Command: Returns the coefficients 

of a monic polynomial (a polynomial with a leading coefficient of 1) 
having specific roots. 


{} 

Level 1 

->• Level 1 


[ array ] r00ts 

* [ array ] co @tn cie n ts 



Keyboard Access: 


SDdO^E) 




Affected by Flags: None 


Remarks: The argument must be a real or complex array of length 
n containing the polynomial^ roots. The result is a real or complex 
vector of length n+1 containing the coefficients listed from highest 
order to lowest, with a leading coefficient of 1. 


Example: Find the polynomial that has the roots 2, —3, 4, —5: 


E 2 -3 4 -5 ] PCOEF returns E 1 2 
polynomial x 4 + 2x 3 — 25x 2 — 26# + 120, 


26 129 ], representing the 


Related Commands: PEVAL, PROOT 
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PCONTOUR 


PCONTOUR 

PCONTOUR Plot Type Command: Sets the plot type to 
PCONTOUR. 


Keyboard Access: 


f*r)fPLOT)fNXT) 





Affected by Flags: None 


Remarks: When plot type is set PCONTOUR, the DRAW command 

plots a contour-map view of a scalar function of two variables. 
PCONTOUR requires values in the reserved variables EQ , VP A R , and 


PPAR . 


VPAR is made up of the following elements: 

LXieft ^right 2/near 2/far z \ow z high ^min ^max 2/mln 2/max ^eye 2/eye 

2 eye ^step 2/step 

For plot type PCONTOUR, the elements of VPAR are used as follows: 

■ £ [eft and £ right are real numbers that specify the width of the view 
space. 

■ 2/near and y Ur are real numbers that specify the depth of the view 
space. 

■ 2, ow and £ h j gh are real numbers that specify the height of the view 
space. 

■ a: m j n and £ max are not used. 

■ y min and ^ max are not used. 

■ x eye , 2/eye ? and ye are real numbers that specify the point in 
space from which the graph is viewed. 

■ #step and y s tep are real numbers that set the number of 
x-coordinates versus the number of y-coordinates plotted. 

The plotting parameters are specified in the reserved variable PPAR, 

which has this form: 


<®mi n> 2/min- ; ’ 2/max > tndep res axes ptype depend > 

For plot type PCONTOUR, the elements of PPAR are used as follows: 

■ *'■ x m in j 2/m in n °t used. 

■ Umax, 2/m ax > is not used. 
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PCONTOUR 


■ indep is a name specifying the independent variable. The default 

value of indep is X. 

■ res is not used. 

■ axes is not used. 

■ piype is a command name specifying the plot type. Executing the 
command PCONTOUR places the name PCONTOUR in piype. 

m depend is a name specifying the dependent variable. The default 
value is Y. 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 
POLAR, SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, 
YSLICE 


PCOV 

Population Covariance Command: Returns the population 

covariance of the independent and dependent data columns in the 
current statistics matrix (reserved variable SDAT). 


Level 1 -► Level 1 




covaria nee 


Keyboard Access: f<hl( stat ) IlllfilS [nxti llllili! 


Affected by Flags: None 


Remarks: The columns are specified by the first two elements in 
reserved variable SPAR, set by XCOL and YCOL respectively. If 
SPAR does not exist, PCOV creates it and sets the elements to their 
default values (1 and 2). 

The population covariance is calculated with the following formula: 
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PDIM 


where Xk ni is the itth coordinate value in column n 1 , Xkn 2 is the kth 
coordinate value in the column n 2 , xCl is the mean of the data in 
column n x , x^ is the mean of the data in column n 2 , and n is the 
number of data points. 

Related Commands: COLE, CORR, COV, PREDX, PREDY, 
XCOL, YCOL 


PDIM 



PICT Dimension Command: Replaces 

PICT with a blank PICT of 

the specified dimensions. 


{} 

Level 2 

Level 1 

Level 1 

^min ^minl (*m ax t-Vm ax) 


^^wldth 

eig h t 

- 


Keyboard Access: (pro! lltllliII 


Affected by Flags: None 


Remarks: If the arguments are complex numbers, PDIM changes the 
size of PICT and makes the arguments the new values of (x m]n . ^ mln ) 
and (r m ax, y max) in the reserved variable PPAR. Thus, the scale 
of a subsequent plot is not changed. If the arguments are binary 
integers, PPAR remains unchanged, so the scale of a subsequent plot 
is changed. 

PICT cannot be smaller than 131 pixels wide x 64 pixels high, nor 
wider than 2048 pixels (height is unlimited). 

Related Commands: PMAX, PM1N 
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PERM 

Permutations Function: Returns the number of possible 

permutations of n items taken m at a time. 


Level 2 


Level 1 


Level 1 


'symb n 


’symbn' 


m 


m 


' symb m 
'symb m 


P n >m 

'PERM(symb n , m y 

'PERM(n, symbm )' 
PERM(symt>„ , symbm ) 


Keyboard Access: (mth! (nxti lllliill flfilill 

Affected by Flags: Numerical Results (-3) 

Remarks: The formula used to calculate m is this: 


P 


n\ 


n ,m 


(n — m) 


The arguments n and m must each be less than 10 12 . 

Related Commands: COMB, ! 


PEVAL 

Polynomial Evaluation Command: Evaluates an n-degree 

polynomial at x. 


Level 2 


[ array ] C oefficfents 


Level 1 


Level 1 


p(x) 
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PGDIR 


Affected by Flags: None 

Remarks: The arguments must be an array of length n +1 containing 
the polynomial's coefficients listed from highest order to lowest, and 
the value x at which the polynomial is to be evaluated. 

Example: Evaluate the polynomial x 4 + 2x 3 — 2bx 7 - 26 x + 120 
at x = 8: 




26 126 ] 


returns 343 


4 


Related Commands: PCOEF, PROOT 


PGDIR 


Purge Directory Command: 

empty or not). 

Purges the named directory (whether 


o 

Level 1 

-»■ Level 1 

1 global 1 —► 


Keyboard Access: 


(memory) IISISII iiSli 

N ■■ 1 ./ ^ ~ M ■ l'.y vr- 


Affected by Flags: None 


Related Commands: CLVAR, CRDIR, HOME, PATH, PURGE, 
UPDIR 
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PICK 

Pick Object Command: Copies the contents of a specified level to 

level 1. 


i Level n+1.. 

Level 2 Level 1 - 

■* Level n+1.. 

Level 2 

Level 1' 

Obj n ■■ 

obj 1 n 

-+ oh/n ,. 

obj 1 

obj n 


Keyboard Access: ( 4 ^) (stack) Spilt-- 


Affected by Flags: None 


niJijiii 



Related Commands: DUP, DUPN, DUP2, OVER, ROLL, ROLLD, 
ROT, SWAP 


PICT 

PICT Command: Puts the name PICT on the stack. 


Level 1 



Level 1 


PICT 


Keyboard Access: (prgi 


■JbWi. 


i IW., ■ 


mmm® 




Affected by Flags: None 

Remarks: PICT is the name of a storage location in calculator 
memory containing the current graphics object. The command PICT 
enables access to the contents of that memory location as if it were a 
variable. Note, however, that PICT is not a variable as defined in the 
HP 48: its name cannot be quoted, and only graphics objects may be 
“stored” in it. 
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PICTURE 


If a graphics object smaller than 131 wide x 64 pixels high is stored in 
PICT , it is enlarged to 131 x 64. A graphics object of unlimited pixel 
height and up to 2048 pixels wide can be stored in PICT. 

Examples: PICT RCL returns the current graphics object,to the 

stack. 


GRAPHIC 131 x 64 PICT STO stores a graphics object in PICT, 
making it the current graphics object. 


Related Commands: GOR, GXOR, NEG, PICTURE, PVIEW, 
RCL, REPL, SIZE, STO, SUB 


PICTURE 


Picture Environment Command: Selects the Picture environment 

(selects the graphics display and activates the graphics cursor and 
Picture menu). 

Keyboard Access: [^[picture) 

Affected by Flags: None 


Remarks: When executed from a program. PICTURE suspends 

program execution until [CANCEL 1 is pressed. 

Example: This program: 


■s "Press uflNuEL to ret urns to 
3 WRIT PICTURE a 



1 DISP 


displays a message for 3 seconds, then selects the Picture environment. 
(The ■ character in the program indicates a linefeed.) 

Related Commands: PICTURE, PVIEW, TEXT 
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PINIT 

Port Initialize Command: Initializes all currently active ports. Does 

not affect data already stored in a port. 

Keyboard Access: f^TK library 1 (TjxT ) SilBi 


» b - - - ■ — 


Affected by Flags: None 
Related Commands: None 

Remarks: PINIT is particularly useful when using a plug-in card 
that can hold multiple ports. It stores and then purges an object 
in each port (128K partition) that can be accessed at the time the 
command is executed. This has the effect of initializing each port 
without disturbing any previously-stored data. 


PIXOFF 

Pixel Off Command: Turns off the pixel at the specified coordinate 
in PICT. 



Level 1 


Level 1 


(*, y) 

{ #n#m} 


Keyboard Access: [prg! 1 1118 11 fFjxT) gg liil 

Affected by Flags: None 
Related Commands: PIXON, PIX? 
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PIXON 

Pixel On Command: Turns on the pixel at the specified coordinate in 
PICT. 


Level 1 -v Level 1 

(X, y) 

{ #m } -*■ 


Keyboard Access: (prg) ipatiij: ( nxt ) p 

. i-j--------- - - . . ,. , i ih-> - -^F ■ i . ■ - * - 

Affected by Flags: None 

Related Commands: PIXOFF, PIX? 

SUf 

J 1 J ----i ■ rri rni i 1 i r 

■ ear-i--iprpi i i i» i 1 1 1 1 « 

PIX? 

Pixel On? Command: Tests whether the specified pixel in PICT is 

on; returns 1 (true) if the pixel is on, and 0 

(false) if the pixel is off. 

Level 1 — 

Level 1 

(X, y) ->■ 

0/1 

{#n #m} - 

0/1 


Keyboard Access: (prg) PIcT (nxt! 3BBR- 

^ ■. . 


Affected by Flags: None 


Related Commands: PIXON, PIXOFF 
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PKT 



Packet Command: 

Used to send command 

“packets” (and receive 

requested data) to a 

Kermit server. 

{> 

Level 2 

Level 1 -► 

Level 1 

"data" 

"type" —► 

"response" 


Keyboard Access: 




Affected by Flags: I/O Device (—33), I/O Messages (—39) 

The I/O Data Format flag (—35) can be significant if the server sends 
back more than one packet. 


Remarks: To send HP 48 objects, use SEND. 


PKT allows additional commands to be sent to a Kermit server. For 
more information, refer to Using MS-DOS Kermit by Christine M. 
Gianone, Digital Press, 1990; or KERMIT, A File Transfer Protocol 
by Frank da Cruz, Digital Press, 1987. especially chapter 11, “The 
Client/Server Model.” 

The packet data, packet type, and the response to the packet 

transmission are all in string form. PKT first does an I (initialization) 
packet exchange with the Kermit server, then sends the server a 
packet constructed from the data and packet-type arguments supplied 
to PKT. The response to PKT will be either an acknowledging string 
(possibly blank) or an error packet (see KERRM). 

For the type argument, only the first letter is significant. 

Examples: A PKT command to send a generic directory request is 
!, D" 11 G" PKT. 


To send a host command packet, use a command from the server’s 
operating system for the data string and "C n for the type string. For 
example, 11 'ABC' PURGE" "C" PKT on a local HP 48 would instruct 
an HP 48 server to purge variable ABC. 

Related Commands: CLOSER), KERRM, SERVER 
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PMIN 


PMAX 


PICT Maximum Command: Specifies < x, 

the upper right corner of the display. 

y’> as the coordinates at 


{> 

Level 1 -► 

Level 1 

(X, y) ->■ 


Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: The complex number <x ) y > is stored as the second 
element in the reserved variable PPAR. 

Related Commands: PDIM, PMIN, XRNG, YRNG 


PMIN 

PICT Minimum Command: Specifies ix, y > as the coordinates at the 
lower left corner of the display. 


_ {} 

Level 1 -* Level 1 

(x,y) 


Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: The complex number <.x. y > is stored as the first element 
in the reserved variable PPAR. 

Related Commands: PDIM, PMAX, XRNG, YRNG 
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POLAR 


Polar Plot Type Command: Sets the plot type to POLAR. 


Keyboard Access: 


(±D(plot) 



p r r r r ■-! 



Affected by Flags: Simultaneous Plotting (—28), Curve Filling 
(-31) 


Remarks: When the plot type is POLAR, the DRAW command 
plots the current equation in polar coordinates, where the independent 
variable is the polar angle and the dependent variable is the radius. 
The current equation is specified in the reserved variable EQ. 


The plotting parameters are specified in the reserved variable PPAR, 
which has this form: 


C c ^min> in > (max) indep res axes ptype depend } 

For plot type POLAR, the elements of PPAR are used as follows: 

■ <x m j n , y m j n > is a complex number specifying the lower left corner 
of PICT (the lower left corner of the display range). The default 
value is < - 6.5 ? - 3.. 1 >. 

■ Umax) fmax ;i is a complex number specifying the upper right 
corner of PICT (the upper right corner of the display range). The 
default value is < 6 » 5 ? 3 □ 2 >. 

■ indep is a name specifying the independent variable, or a list 
containing such a name and two numbers specifying the minimum 
and maximum values for the independent variable (the plotting 
range). The default value of indep is X. 

u res is a real number specifying the interval, in user-unit coordinates, 
between values of the independent variable. The default value is 8, 
which specifies an interval of 2 degrees, 2 grads, or 7 t/ 90 radians. 

■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin, a list specifying the tick-mark annotation, and two 
strings specifying labels for the horizontal and vertical axes. The 
default value is < 08 >. 

m 

■ ptype is a command name specifying the plot type. Executing the 
command POLAR places the name POLAR in ptype . 
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■ depend is a name specifying a label for the vertical axis. The default 
value is Y. 

The current equation is plotted as a function of the variable specified 
in mdep. The minimum and maximum values of the independent 
variable (the plotting range) can be specifed in indtp ; otherwise, 
the default minimum value is 0 and the default maximum value 
corresponds to one lull circle in the current angle mode (360 degrees, 
400 grads, or 2 tt radians). Lines are drawn between plotted points 
unless flag —31 is set. 

If flag —28 is set, all equations are plotted simultaneously. 

If EQ contains an expression or program, the expression or program 
is evaluated in Numerical Results mode for each value of the 
independent variable to give the values of the dependent variable. If 
EQ contains an equation, the plotting action depends on the form of 
the equation. 


Form of 

Current Equation 

Plotting Action 

‘ expr-expr 1 

Each expression is plotted separately. 


The intersection of the two graphs shows 


where the expressions are equal. 

' name-expr ! 

Only the expression is plotted. 


Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 
PCONTOUR. SCATTER, SLOPEFIELD, TRUTH, WIREFRAME, 
YSLICE 
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POS 

Position Command: Returns the position of a substring within a 
string or the position of an object within a list. 


Level 2 

Level 1 

-*• Level 1 

" string” 

" substring " 

-+ n 

{ list } 

obj 

n 


Keyboard Access: 



Affected by Flags: None 

Remarks: If there is no match for obj or substring. POS returns 
zero. 

Related Commands: CHR, NUM, REPL, SIZE, SUB 



Keyboard Access; None. Must be typed in. 
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PREDX 

Remarks: Provided for compatibility with the HP 28. PREDV is the 
same as PREDY. See PREDY. 


PREDX 

Predicted X-Value Command: Returns the predicted independent- 

variable value ^independent? based on the dependent-variable value 
^dependent? the currently selected statistical model, and the current 
regression coefficients in the reserved variable SPAR. 


{} 


Level 1 

-*■ Level 1 

•^dependent 

^independent 


Keyboard Access: f^lfsTATl l—i 


Affected by Flags: None 



Remarks: The value is predicted using the regression coefficients 
most recently computed with LR and stored in the reserved variable 
EPAR. For the linear statistical model, the equation used is this: 


Vdependent — independent) ® 

where m is the slope (the third element in EPAR) and b is the 
intercept (the fourth element in EPAR). 

For the other statistical models, the equations used by PREDX are 
listed in the LR entry. 

If PREDX is executed without having previously generated regression 
coefficients in EPAR, a default value of zero is used for both 
regression coefficients, and an error results. 

Example: Given five columns of data in EDAT, the command 
sequence: 



YCDL 


LOGFIT LR 


FRED 


V 


sets column 2 as the independent variable column, sets column 5 as 
the dependent variable column, and sets the logarithmic statistical 
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PREDX 


model. It then executes LR, generating intercept and slope regression 
coefficients, and storing them in SPAR. Then, given a dependent 
value of 23, it returns a predicted independent value based on the 
regression coefficients and the statistical model. 

Related Commands: COLE, CORR, COV, EXPFIT, ELINE, 
LINFIT, LOGFIT, LR, PREDY, PWRFIT, XCOL, YCOL 


PREDY 

Predicted y-Value Command: Returns the predicted dependent- 

variable value ^dependent? based on the independent-variable value 
^independent) the currently selected statistical model, and the current 
regression coefficients in the reserved variable SPAR. 


{} 

Level 1 

-+ Level 1 


^independent 

■'dependent 



Keyboard Access: 


f*T) fSTAT) 



Affected by Flags: None 


Remarks: The value is predicted using the regression coefficients 
most recently computed with LR and stored in the reserved variable 
SPAR. For the linear statistical model, the equation used is this: 


Vdependent —' independent) r 0 

where m is the slope (the third element in SPAR) and b is the 
intercept (the fourth element in SPAR). 

For the other statistical models, the equations used by PREDY are 
listed in the LR entry. 

If PREDY is executed without having previously generated regression 
coefficients in S PAR , a default value of zero is used for both 
regression coefficients—in this case PREDY will return 8 for statistical 
models LINFIT and LOGFIT, and error for statistical models 
EXPFIT and PWRFIT. 


3-236 Command Reference 




















PRLCD 


Example: Given four columns of data in SDAT\ the command 
sequence: 


2 XCOL 4 VCOL PI4RFIT LR 11 PREDY 


sets column 2 as the independent variable column, sets column 4 
as the dependent variable column, and sets the power statistical 
model. It then executes LR, generating intercept and slope regression 
coefficients, and storing them in I]PAR. Then, given an independent 
value of 11, it returns a predicted dependent value based on the 
regression coefficients and the statistical model. 


Related Commands: COLE, CORR, COV, EXPFIT, ELINE, 
LINFIT, LOGFIT, LR, PREDX, PWRFIT, XCOL, YCOL 


PRLCD 


Print LCD Command: Prints a pixel-by-pixel image of the current 
display (excluding the annunciators). 


Keyboard Access: QQ/o) 1§J 




Affected by Flags: Printing Device (—34), I/O Device (—33), 
Linefeed (—38) 


If flag —34 is set (printer output directed to the serial port), flag —33 
must be clear. 


Flag —38 must be clear. 

Remarks: The width of the printed image of characters in the 
display is narrower using PRLCD than using a print command such 
as PR1. The difference results from the spacing between characters. 

On the display there is a single blank column between characters, and 
PRLCD prints this spacing. Print commands such as PR1 print, two 
blank columns between adjacent characters. 

Example: The command sequence ERASE DRAW PRLCD clears PICT , 

plots the current equation, then prints the graphics display. 

Related Commands: CR, DELAY, OLDPRT, PRST, PRSTC, 
PRVAR, PR1 
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PROMPT 

Prompt Command: Displays the contents of " prompt " in the status 
area, and halts program execution. 


_ {_} 

Level 1 — Level 1 I 

" prompt " —► 


Keyboard Access: 


PRGi fN)CT 



Affected by Flags: None 


Remarks: PROMPT is equivalent to 1 DISP 1 FREEZE HRLT. 


Related Commands: CONT, DISP, FREEZE, HALT, INFORM, 
INPUT, MSGBOX 


PROOT 

Polynomial Roots Command: Returns all roots of an n-degree 

polynomial having real or complex coefficients. 


Level 1 

- Level 1 i 

[ array ] C0€fPi C ients 

- [ array Jroots 1 


Keyboard Access: 



Affected by Flags: Infinite Result Exception (—22) 


Remarks: For an n th -order polynomial, the argument must be a 
real or complex array of length ra+1 containing the coefficients listed 
from highest order to lowest. The result is a real or complex vector of 
length n containing the computed roots. 
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PR ST 


PROOT interprets leading coefficients of zero in a limiting sense. 

As a leading coefficient approaches zero, a root of the polynomial 
approaches infinity: therefore, if flag —22 is clear (the default), 

P ROOT reports an Infinite Result error if a leading coefficient is zero. 
If flag —22 is set, PROOT returns a root of (MAXREAL,0) for each 
leading zero in an array containing real coefficients, and a root of 
(MAXREAL,MAXREAL) for each leading zero in an array containing 
complex coefficients. 

Example: Find the roots of the polynomial £ 4 +2# 3 — 25a: 2 — 26a?-h 120: 


C 1 2 “25 -26 120 ] PROOT returns [ 



Related Commands: PCOEF, PEVAL 


PRST 


Print Stack Command: Prints all objects in the stack, starting with 

the object in the highest level. 


Keyboard Access: 



hmh b 




Affected by Flags: Double-Spaced Printing (—37), Printing Device 
(—34), I/O Device (—33), Linefeed (—38) 

If flag —34 is set (printer output directed to the serial port), flag —33 
must be clear. 


When flag —38 is set, linefeeds are not added at the end of each print 
line. Generally, flag —38 should be clear for execution of PRST. PRST 

leaves the stack unchanged. 

Remarks: Objects are printed in multiline printer format. See the 

PR1 entry for a description of multiline printer format. 

Related Commands: OR, DELAY, OLDPRT, PRLCD, PRSTC, 
PRVAR, PR1 
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PRSTC 


Print Stack (Compact) Command: Prints in compact form all 

objects in the stack, starting with the object in the highest level. 


Keyboard Access: ® Q/o} 




i V/ 3 v.vfv.vl^i; 


Affected by Flags: Double-Spaced Printing (—37), Printing Device 
(—34), I/O Device (—33), Linefeed (—38) 


If flag —34 is set (printer output directed to the serial port), flag —33 
must be clear. 


When flag —38 is set, linefeeds are not added at the end of each print 
line. Generally, flag —38 should be clear for execution of PRSTC. 

Remarks: Compact printer format is the same as compact display 
format. Multiline objects are truncated and appear on one line only. 
PRSTC leaves the stack unchanged. 

Related Commands: CR, DELAY, OLDPRT, PRLCD, PRST, 
PRVAR, PR1 


PRVAR 

Print Variable Command: Searches the current directory path or 

port for the specified variables and prints the name and contents of 
each variable. 


Level 1 Level 1 

1 name ' —► 

{ name 1 name 2 ... } —*► 

:n port .'global 1 —► 


Keyboard Access: 




Affected by Flags: Double-Spaced Printing (—37), Printing Device 
(—34), I/O Device (—33), Linefeed (—38) 
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If flag —34 is set (printer output directed to the serial port), flag —33 
must be clear* 

When flag —38 is set, linefeeds are not added at the end of each print 
line. Generally, flag —38 should be clear for execution of PRVAR, 

Remarks. Objects are printed in multiline printer format. See the 
PR1 entry for a description of multiline printer format. 

Related Commands: CR, DELAY, OLDPRT, PR1, PRLCD, PRST, 
PRSTC 


PR1 

Print Level 1 Command: Prints an object in multiline printer 

format. 


Keyboard Access: Q(T/o) 


lliiiiv 
I i i -i ■ ■ I ■ ■ 
I i i 1 ■ I • i 


Affected by Flags: Double-Spaced Printing (—37), Printing Device 

(—34), I/O Device (—33), Linefeed (—38) 


If flag —34 is set (printer output directed to the serial port), flag —33 
must be clear. 


Remarks: All objects except strings are printed with their identifying 
delimiters. Strings are printed without the leading and trailing “ 
delimiters. PR1 leaves the stack unchanged. 

Multiline printer format is similar to multiline display format, with the 
following exceptions: 

■ Strings and names that are more than 24 characters long are 
continued on the next printer line. 

■ The real and imaginary parts of complex numbers are printed on 
separate lines if they don’t fit on the same line. 

■ Arrays are printed with a numbered heading for each row and with 

a column number before each element. For example, the 2 x 3 array 

'l 2 3" 

4 5 6 

would be printed as follows: 
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PR1 

firray {23} —Array dimensions 
Row number — Row 1 

r 13 1 

Column number j 23 2 

,3] 3 

Row 2 
1] 4 
23 5 
33 6 


Related Commands: CR, DELAY, OLDPRT, PRLCD, PRST, 
PRSTC, PRVAR 


PSDEV 

Population Standard Deviation Command: Calculates the 

population standard deviation of each of the m columns of coordinate 
values in the current statistics matrix (reserved variable UDAT ). 

Level 1 Level 1 

** x p s d e v 

^ t x psdevl x psdev2 *** x psdevm J 



Affected by Flags: None 


Remarks: PSDEV returns a vector of m real numbers, or a single 
real number if in = 1. The population standard deviation is computed 
using this formula: 
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PURGE 



where x K is the k th coordinate value in a column, x is the mean of the 
data in this column, and n is the number of data points. 


Related Commands: MEAN, PCOV, PVAR, SDEV, TOT, VAR 


PURGE 

Purge Command: Purges the named variables or empty 
subdirectories from the current directory. 


Level 1 


Level 1 


' global' 

{ global ... global n } 

PICT 


: "port :n3me backup 
*^port '^library 


Keyboard Access: (♦vll purge 1 
Affected by Flags: None 

Remarks: PURGE executed in a program does not save its argument 
for recovery by LASTARG. 

To empty a named directory before purging it, use PGDIR. 

To help prepare a list of variables for purging, use VARS. 

Purging PICT replaces the current graphics object with a 0 x 0 
graphics object. 

If a list of objects (with global names, backup objects, library objects, 
or PICT ) for purging contains an invalid object, then the objects 
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PURGE 


preceding the invalid object are purged, and the error Bad Rrgunent 
Type occurs. 

To purge a library or backup object, tag the library number or backup 
name with the appropriate port number (s ra port ), which must be in 
the range from 0 to 33. (A library can be purged from RAM only.) 

For a backup object, the port number can be replaced with the 
wildcard character in which case the HP 48 will search ports 33 
through 0, and then main memory for the named backup object. 

Library objects in RAM can be purged, while those in ROM 
(application cards and write-protected RAM cards) cannot. A library 
object must be detached before it can be purged from the HOME 
directory, 

Neither a library object nor a backup object can be purged if it is 
currently “referenced” internally by stack pointers (such as an object 
on the stack, in a local variable, on the LAST stack, or on an internal 
return stack). This produces the error Object in Use. To avoid 
these restrictions, use NEWOB before purging. (See NEWOB.) 

Related Commands: CLEAR, CLUSR, CLVAR, NEWOB, PGDIR 


PUT 

Put Element Command: In the level 3 array or list, PUT replaces 

with z put or obj put the object whose position is specified in level 2; if 
the array or list is unnamed, returns the new array or list. 
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PUT 


Level 3 

[[ matrix ]] t 
[[ matrix ]], 


Level 2 


Level 1 


Level 1 


name 


matrix 


"^matrix 
[ vector ] x 

[ vector ] x 


name 


vector 


name yQC i or 

{ Ust }! 
{list} , 


'name nst ' 
'name 



^position 


u t 

{ 

n row m co\ 

} 

^•p u t 


"p ositio n 


^pUt 

{ 

n row U? co | 

} 

^p u t 


"positio n 


z p u t 

{ 

^position 

} 

^PU t 


n positio n 


HP u t 

{ 

ositio n 

} 

z put 


^p ositio n 


ob -i P u t 

{ 

^position 

} 

ob Jp u t 


,7 p o s i 11 o n 


put 

{ 

^position 

} 

°h/p u t 

ss 




: fPRGll 

an 

■ 1 ■ ! 9 . . I a I • ! 1 ■ 1 . 1 

UK E L EM 

-- ■ u ■ 4 if 4 4 H 4 i i d i ■ 4 i*-fc -------- 


[[ matrix ]] 
[[ matrix ]] 


[ vector ] 2 
[ vector ] 2 


{ list } 2 
{ list } 2 


■ 1 * II a 4 + - :■ J H 

■ a a * q 4 i fM H i 


Keyboard Access: 

Affected by Flags: None 

Remarks: For matrices, ft position counts in row order. 

If the argument in level 3 is a name, PUT alters the named array or 
list and returns nothing to the stack. 

Examples: This command sequence: 

[[ 2 3 4 ]C 4 1 2 31 { 13) 96 PUT returns 
EE 2 3 96 IE 4 1 2 ]]. 


The command sequence [ [ 2 3 4 ] E 4 1 2 ] ] 5 96 PUT returns 
EE 2 3 4 ][ 4 96 2 ]]. 


The command sequence C H B C D E > L 3 > 1 Z 1 PUT returns 
>. fi B Z E- 1 E .!■. 

Related Commands: GET, GETI, PUTT 
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PUTI 


Put and Increment Index Command: In the level 3 array or list, 

replaces with z put or obj put the object whose position is specified in 
level 2, returning the new array or list and the next position in that 
array or list. 


Level 3 


Level 2 Level 1 


Level 2 


Level 1 


[[matrix]^ n posl 
[[ matrix ]]. { n r m c }, 


"^matrix 


n posl 


‘name llst 1 


{ OS 1 


name m atrix ' { n < m c 

[vector]! n posl 

[vector]! ( "posi > 

name vector' n Qos 

name vector ' { n posl } 

{ Ust }! n p0 si 

{ Ust }i { n D0Sl } 


^pos 


{ n 


posl 


name 


list 


n posl 
{ ^posl 
n pQSl 
i ^posl 


put 

put 

I 

put 

* 

put 

put 

¥ 

put 
p u t 


put 


of >jp u t 

ob Jf> u t 
Ob J 0 u t 


[[ matrix ]] 
[[ matrix ]] 


name 


name 


m a trix 


m a trix 


[ vector ] 2 
[ vector ] 2 


name 


vector 


put 


/?^^®vec tor 

{ list >2 

{ list } 2 


'name ljst ' 

1 /73/7?e,j st 1 


^pOs2 

{ n r me } 2 
^pos2 

{ n r m c } 2 

^pos2 
{ ^pos2 ) 
n pos2 
{ ^pos2 } 
^p os2 
{ ^pos2 } 
^p os2 
{ n pos2 } 


Keyboard Access: 



Affected by Flags: Index Wrap Indicator (—64) 


The Index Wrap Indicator flag is cleared on each execution of PUTI 
until the position (index) wraps to the first position in the array or 
list 5 at which point the flag is set. The next execution of PUTI again 
clears the flag. 


Remarks: For matrices, the position is incremented in row order. 


Unlike PUT, PUTI returns a named array or list (to level 2). This 
enables a subsequent execution of PUTI at the next position of a 
named array or list. 

Example: The following program uses PUTI and flag —64 to replace 
A, B, and C in the list with X . 
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« (ABC > DO 1 K 1 PUT I UNTIL -64 FS? END » 

Related Commands: GET, GETI, PUT 


PVAR 

Population Variance Command: Calculates the population variance 

of the coordinate values in each of the m columns in the current 
statistics matrix ( EDAT ). 


Level 1 


Level 1 


pvaria nee 


[*pvariancel ■■■ *pvarian 


ce m 


• DM ' 1 I’ ” I” ■■P*!’ ■ - 

t £J.v 


i^i J ,JJ -- - - 




Keyboard Access: H-T'i f stat ] ilaWl inxt ) j jSi Hi 

• ^w . ... ■ . 

Affected by Flags: None 

Remarks: The population variance (equal to the square of the 
population standard deviation) is returned as a vector of m real 
numbers, or as a single real number if m — 1. The population 
variances are computed using this formula: 

k = l 

where x k is the kih coordinate value in a column, x is the mean of the 
data in this column, and n is the number of data points. 

Related Commands: MEAN, PCOV, PSDEV, SDEV, VAR 


Command Reference 3-247 















PVARS 

Port-Variables Command: Returns a list of the backup objects 

(s ra port : name) and the library objects (s n port : n nbrary ) in the 
specified port. Also returns the available memory size (if RAM) or the 
memory type. 


{} 


Level 1 

- Level 2 

Level 1 

^port ” 

{ *^port ‘^^^^backup *** ) 

memory 

^port “ 

f ’^port ‘library *‘ 4 J 

memory 


Keyboard Access: p4^1f library) «||il 


Affected by Flags: None 


Remarks: The port number, n port , must be in the range from 0 to 

33. 


■ If n port = 0, then memory is bytes of available main RAM. 

■ If the port contains independent RAM, then memory is bytes of 
available RAM in that port. 

■ If the port contains merged RAM , then memory is "SYSRRM". 

■ If the port contains ROM, then memory is "ROM". 

■ If the port is empty, then the message Port Not Ryai lable 
appears. 

Related Commands: PVARS, VARS 
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PVIEW 

PICT View Command: Displays PICT with the specified coordinate 
at the upper left corner of the graphics display. 


j --- ---—-- 

Level 1 

- 

Level 1 

(X, y) 

- 


{ #n #m } 

- 


u 




Keyboard Access: 


-BBPa r - HP ■ ■ fc ■ i J_.j t . i iibii- r r i 9 e b r ■ i i III ill . i i i i i ■ 

fpRGi fNxTl mwm asi®j 

i> V a.. -r T T -r r »■■■■■■■■ n ■ r ■ ■ ■ ■ l ■ i a . i >i i t i ■ i * -a -9 -a ■ ■ ■ r - - - ir J- j- - ■ r r ■ p f r n i . ■ . i i > . 

. .. 


fpRGi taiais riMXTi mam 

Affected by Flags: None 


Remarks: PICT must fill the entire display on execution of PVIEW. 
Thus, if a position other than the upper left corner of PICT is 
specified, PICT must be large enough to fill a rectangle that extends 
131 pixels to the right and 64 pixels down. 


If PVIEW is executed from a program with a coordinate argument 
(versus an empty list), the graphics display persists only until the 
keyboard is ready for input (for example, until the end of program 
execution). However, the FREEZE command freezes the display until 
a key is pressed. 

If PVIEW is executed with an empty list argument, PICT is centered 
in the graphics display with scrolling mode activated. In this case, the 
graphics display persists until [CANCEL ) is pressed. 

PVIEW does not activate the graphics cursor or the Picture menu. To 
activate the graphics cursor and Picture menu, execute PICTURE. 

Example: The program 


# 6d # 0d 


PVIEW 7 FREEZE 


Vt 


» 


m ^ 


displays PICT in the graphics display with coordinates C # 0d # 0d > 
in the upper left corner of the display, then freezes the full display 
until a key is pressed. 
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PVIEW 

Related Commands: FREEZE, PICTURE, TEXT 


PWRFIT 


Power Curve Fit Command: Stores PWRFIT as the fifth parameter 

in the reserved variable EPAR, indicating that subsequent executions 
of LR are to use the power curve fitting model. 


Keyboard Access: 


QfsW) 




Affected by Flags: None 


Remarks: LINFIT is the default specification in EPAR. For a 
description of EPAR, see appendix D, “Reserved Variables.” 

Related Commands: BESTFIT, EXPFIT, LINFIT, LOGFIT, LR 


PX^C 

Pixel to Complex Command: Converts the specified pixel 

coordinates to user-unit coordinates. 


Level 1 

+ Level 1 


{ #/? #/77 } 

■+ (*, y) 



Keyboard Access: fPRGl — fNXTl lillil 


Affected by Flags: None 


Remarks: The user-unit coordinates are derived from the 

x m i rn Vm in and (aj max , 2/max ^ parameters in the reserved variable 
PPAR. The coordinates correspond to the geometrical center of the 

pixel. 


Related Commands: C^PX 
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To Quotient Command: Returns a rational form of the argument. 


{} 

Level 1 

» Level 1 


X - 

* 'a/b' 


(x,y) 

* *a/b+c/d*\' 


*symb 1 ' - 

> 1 symb 2 1 



Keyboard Access: f+nf symbolic ) fisixTI 



Affected by Flags: Number Display (—45 to —50) 

Remarks: The rational result is a “best guess '. since there might be 
more than one rational expression consistent with the argument. — 
finds a quotient of integers that agrees with the argument to within 
the number of decimal places specified by the display format mode. 

—also acts on numbers that are part of algebraic expressions or 
equations. 


Example: 



■H! returns 


V+: 


J / 



Related Commands: / 


—>-Q7r 

To Quotient Times n Command: Returns a rational form of the 

argument, or a rational form of the argument with w factored out, 
whichever yields the smaller denominator. 
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{} 


Level 1 

* Level 1 

1 X 

■» 'a/5% 1 

X 

+ x a/b' 

1 symb r 1 

■+ 'symb 2 1 

(x,y) 

■+ 1 a/b*7r-\-c/d*7T *i 1 

(x,y) 

■+ 1 a/b+ c/d*\ ' 


Keyboard Access: f^Tlf symbolic 



Affected by Flags: Number Format (—45 to —50) 


Remarks: ^Qtt computes two quotients (rational expressions) and 
compares them: the quotient of the argument, and the quotient of 
the argument divided by 7r. It returns the fraction with the smaller 
denominator; if the argument was divided by 7r, then 7r is a factor in 
the result* 


The rational result is a “best guess/* since there might be more than 
one rational expression consistent with the argument. —>Q7r finds a 
quotient of integers that agrees with the argument to the number of 
decimal places specified by the display format mode. 

—>Q 7 r also acts on numbers that are part of algebraic expressions or 
equations. 

For a complex argument, the real or imaginary part (or both) can 
have 7r as a factor. 


Example: In Fix mode to four decimal places, 


: O O O O 


*Qtt returns 


1 2* TT 


In Standard mode, however, 6 


,i * i ’i 

3 T. I 


■+ Qrr returns 3927- 6 


Related Commands: -^Q, /, 7r 
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QR 

QR Factorization of a Matrix Command: Returns the QR 

factorization of an nxm, matrix. 


{} 


Level 1 

Level 3 

Level 2 

Level 1 

[[ matrix ]] A 

[[ matrix ]] Q 

[[ matrix ]] R 

[[ matrix ]] p 


Keyboard Access: [mth! HIM! Sill! 


mmm 


Affected by Flags: None 

Remarks: QR factors mxn matrix A into three matrices 

■ Q is an mxm orthogonal matrix. 

■ R is an m x n upper trapezoidal matrix. 

■ P is a nxn permutation matrix. 

Where AxP = QxR. 


Related Commands: LQ, LSQ 


QUAD 

Solve Quadratic Equation Command: Solves an algebraic object 

1 symbi 1 for the variable global, and returns an expression 1 symb 2 1 
representing the solution. 


{} 


Level 2 

Level 1 

> Level 1 

l symb 1 1 

' global 1 

1 symb 2 1 


Keyboard Access: symbolic 1 ||JlIf§ 


Affected by Flags: Principal Solution (—1) 
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Remarks: QUAD calculates the second-degree Taylor series 
approximation of 1 symh 1 1 to convert it to quadratic form. The 

solution ' symb 2 1 is exact if ' symb 1 1 is second degree or less in 
global. 

Since QUAD evaluates 1 symb 1 1 , any variables in 8 symb 1 1 other than 
global should not exist in the current directory if they are to remain in 
the solution as formal variables. 


QUAD generally does not work if global needs units to satisfy the 
equation. 


Example: 1 R * x ■■■ z+m X+c = § 


i ( i 


QIJRD returns 


1 X= 


<-B+sl*T (B2-4# ■£ 8*£/2 > *C ) > / < 2* < R*22 > > 


? 


which reduces to the familiar quadratic solution: 

v _ -B ± VB 2 - 4 AC 

YY - - 


2 A 

Related Commands: COLCT, EXPAN, ISOL, SHOW 


QUOTE 

Quote Argument Function: Returns its argument unevaluated. 


{} 

Level 1 

■+ Level 1 


'symb' 

1 symb 1 


obj 

-+ obj 



Keyboard Access: (^ KsymbqlicI (nxt) fisixTl WUB 


Affected by Flags: None 


Remarks: When an algebraic expression is evaluated, the arguments 
to a function in the expression are evaluated before the function. For 
example, when 1 SINOO ' is evaluated, the name X is evaluated first, 
and the result is left on the stack as the argument for SIN. 
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QUOTE 


This process creates a problem for functions that require symbolic 
arguments. For example, the function f requires as one of its 
arguments a name specifying the variable of integration. If evaluating 
an integral expression caused the name to be evaluated, the result of 
evaluation would be left on the stack for J , rather than the name 
itself. To avoid this problem, the HP 48 automatically (and invisibly) 
quotes such arguments. When the quoted argument is evaluated, the 
unquoted argument is returned. 

If a user-defined function takes symbolic arguments, those arguments 

+ 

must be quoted using QUOTE, as demonstrated in the following 
example. 

Example: The following user-defined function ArcLen calculates the 
arc length of a function: 


start end 

& 

start end 
expr Mar 6 
Mar X 

:$■ 

fENTER! 0 ArcLen ($T0! 


expr Mar 

SQ 1 + X 


To use this user-defined function in an algebraic expression, the 
symbolic arguments must be quoted: 


1 flrcLen<0? 7r ? QUOTE<SIN<X> >, QUOTE<X) > ‘ 

Related Commands: APPLY, | (Where) 
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RAD 

Radians Mods Command: Sets Radians angle mode. 

Keyboard Access: 


modes! 




£1 


nf 


a 


Affected by Flags: None 


Remarks: RAD sets flag - 

ROD annunciator. 



17 and clears 



— 18, and displays the 


In Radians angle mode, real-number arguments that represent angles 
are interpreted as radians, and real-number results that represent 
angles are expressed in radians. 

Related Commands: DEG, GRAD 


RAND 

Random Number Command: Returns a pseudo-random number 
generated using a seed value, and updates the seed value. 


Level 1 


Level 1 




n d o m 


Keyboard Access: (mth) (nxT) IS® 






wmm 


Affected by Flags: None 


Remarks: The HP 48 uses a linear congruential method and a seed 
value to generate a random number a: random in the range 0 < x < L 
Each succeeding execution of RAND returns a value computed from a 
seed value based upon the previous RAND value. (Use RDZ to change 
the seed.) 

Related Commands: COMB, PERM, RDZ, ! 
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RANK 

Matrix Rank Command: Returns the rank of a rectangular matrix. 


{} 

Level 1 

■+ Level 1 


[[ matrix ]] 

* ^rank 



Keyboard Access: ImthI liBHi! fHlilH! f nxt 1 Bill 


Affected by Flags: Singular Value (—54) 


Remarks: Rank is computed by calculating the singular values of 
the matrix and counting the number of nonnegligible values. If all 
computed singular values are zero, RANK returns zero. Otherwise 
RANK consults flag —54 as follows: 


■ If flag —54 is clear (the default), RANK counts all computed 
singular values that are less than or equal to l.E—14 times the 
largest computed singular value. 

■ If flag —54 is set, RANK counts all nonzero computed singular 
values. 


Related Commands: LQ, LSQ, QR 


RANM 

Random Matrix Command: Returns a matrix of specified dimensions 
that contains random integers in the range —9 through 9. 


Level 1 -* Level 1 


{ m n } —► [[ random matrix ]] mxn 

[[ matrix ]] mxn ->■ [[ random matrix ]j mxn 


Keyboard Access: 


[MTHj 
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RANM 

Affected by Flags: None 

Remarks: The probability of a particular nonzero digit occurring is 
0.05; the probability of 0 occurring is 0.1. 

Related Commands: RAND, RDZ 

RATIO 

Prefix Divide Function: Prefix form of / (divide) generated by the 
Equation Writer application. 

Level 2 Level 1 -+ Level 1 

z i 

[ array ] 

[ array ] 
z 

'symb 1 

‘symb-L 1 

#"l 

"i 

#/?i 

x-uniti 
x 

x_ unit 
*symb' 
x-unit 

Keyboard Access: None. Must be typed in. 

Affected by Flags: None 


[[ matrix ]] 


'symb' 


' symb 2 1 


#n 2 

#"2 
y_ unit 2 

y_ unit 


x_ unit 
*symb ' 


zi / z 2 

[[ array x matrix ” 1 ]] 
[ array/z ] 

1 z/symb ' 
'symb/z 1 

1 symb 1 / symb 2 1 

#n 3 

#n 3 

#" 3 

(x/yJ-i/n/t-L /unit 2 

(x/y)_ 1/unit 
(x/y)^unit 
l symb/x-unit' 


X-U 
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RCEQ 


Remarks: RATIO is identical to / (divide), except that, in algebraic 
syntax, RATIO is a prefix function, while / is an infix function. For 
example, ' R fl TICKfi-i 2> 1 is equivalent to 1 fV2 1 . 


RATIO is generated internally by the Equation Writer application 
when is used to start a numerator. It provides no additional 
functionality to / and appears externally only in the string that the 
Equation Writer application leaves on the stack when 
pressed or when the calculator runs out of memory. 





is 


Related Commands: / 


RCEQ 

ReCS 11 from EQ Command: Returns the unevaluated contents of the 
reserved variable EQ from the current directory. 


Level 1 


Level 1 

°^EQ 


Keyboard Access: 


SNfLOTJ HIP 118 


■>1" 1 - f ■. • sr jr j 





II I i il ■« II 
fill j"j"j j i'i I i 


* I I J I I I I 
I I ■ j I i j . 

idiiiJj ii I i j | j 
I ■ I I liiii I III fP| n ■ ■ 

.. 




4“i, 

I i i r bJsTjiT - a 

■’ -l_v.lv- 


p b b r ■ 1 ■ r '! i iiiJj eI j 

p-- ■ r - ■ - ... 


f^TjfPLOT] fr»j SiBrll» (program-entry mode) 


f^jlfPLOT 1 fNXT ) 111@1=1 (program-entry mode) 


Affected by Flags: None 

Remarks: To recall the contents of EQ from a parent directory 
(when EQ doesn’t exist in the current directory) evaluate the name 

EQ . 


Related Commands: STEQ 
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RCI 

Multiply Row by Constant Command: Multiplies row n of a matrix 

(or element n of a vector) by a constant ;r factor , an d returns the 
modified matrix. 


{} 


Level 3 

Level 2 

Level 1 

-* Level 1 


[[ matrix ]] x 

y 

facto r 

"row number 

[[ matrix ]] 2 

—“ -- 

[ vector ] x 

x fa cto r 

n — 

elementn umber 

■+ [ vector ] 2 



Keyboard Access: 

Affected by Flags: None 

Remarks: RCI rounds the row number to the nearest integer, and 
treats vector arguments as column vectors. 

Related Commands: RCIJ 


- .- -.ijjijjii ■ 111 is - ' ■ ■ r 1 i B ■ « ■ 

I MTHl I1I111I 




RCIJ 

Add Multiplied Row Command: Multiplies row i of a matrix by 
a constant £ factor , adds this product to row j of the matrix, and 
returns the modified matrix. Or, multiplies element i of a vector by 
a constant x factor , adds this product to element j of the vector, and 
returns the modified vector. 


{} 


Level 4 

Level 3 

Level 2 

Level 1 

-*■ Level 1 

[[ matrix ]] 1 

*fa ctor 

n t 

row t 

n 

row j 

-4 [[ matrix ]] 2 

[ vector R 

*fa ctor 

n 

elem enti 

^elementj 

-4 [ vector ] 2 


Keyboard Access: (mth) l§®i : l| 
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Affected by Flags: None 

Remarks: RCIJ rounds the row numbers to the nearest integer, and 
treats vector arguments as column vectors. 

Related Commands: RCI 


RCL 

Recall Command: Returns the unevaluated contents of a specified 
variable or plug-in object. 


Level 1 -+ Level 1 

1 name ' —► obj 

PICT —► grob 

' n port -^library 

• n port ' name backu p y obj 


Keyboard Access: ®(rcl) 

Affected by Flags: None 

Remarks: RCL searches the entire current path, starting with the 
current directory. To search a different path, specify C path name }, 
where path is the new path to the variable name . The path 
subdirectory does not become the current subdirectory (unlike EVAL). 

To recall a library or backup object, tag the library number or backup 
name with the appropriate port number (n port ), which must be an 
integer in the range 0 to 33. (A library can be recalled from RAM 
only.) Recalling a backup object brings a copy of its contents to the 
stack, not the entire backup object. 

To search for a backup object, replace the port number with the 
wildcard character & , in which case the HP 48 will search (in order) 
ports 33 through 0, and the main memory for the named backup 
object. 

Related Commands: STO 
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RCLALARM 

Recall Alarm Command: Recalls a specified alarm. 


{} 

Level 1 

- Level 1 


n index 

- { date time ^action ^repeat } 



Keyboard Access: 


SKMD 




Affected by Flags: None 

Remarks: t | 0n is the alarm execution action. If an execution 

action was not specified, o&j action defaults to an empty string. 


£ re peat i s the repeat interval in clock ticks, where 1 clock tick equals 
1/8192 second. If a repeat interval was not specified, the default is 0. 

Related Commands: DEL ALARM, FINDALARM, STOALARM 


RCLF 

Recall Flags Command: Returns a list, containing two 64-bit binary 
integers representing the states of the 64 system and user flags, 
respectively. 


Level 1 

- 

Level 1 


- 

{ # ,? system ^ n user } 


Keyboard Access: 






Affected by Flags: Binary Integer Wordsize (—5 through —10) 


The current wordsize must be 64 bits (the default wordsize) to recall 
the states of all 64 user flags and 64 system flags. If the current 
wordsize is 32, for example. RCLF returns two 32-bit binary integers. 
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RCLKEYS 


Remarks: A bit with value 1 indicates that the corresponding flag is 
set; a bit with value 0 indicates that the corresponding flag is clear. 
The rightmost (least significant) bit of #ft S ystem an( i #rc user indicate 
the states of system flag —1 and user flag +1, respectively. 

Used with STOP, RCLF lets a program that alters the state of a flag 
or flags during program execution preserve the pre-program-execution 
flag status. 

Related Commands: STOF 


RCLKEYS 

Recall Key Assignments Command: Returns the current user key 

assignments. This includes an S if the standard definitions are active 
(not suppressed) for those keys without user key assignments. 


Level 1 


Level 1 


{ x e y 1 * * ■ n ^k e y n } 

{ ^ oty i e y 1 * * * n ^k e y n 1 


Keyboard Access: 


f+ j) [MODES 1 ! lillBll 



Affected by Flags: User-Mode Lock (—61) and User Mode (—62) 

affect the status of the user keyboard. 


Remarks: The argument £ key is a real number of the form rc.p 
specifying the key by its row number r. its column number c, and its 
plane (shift) p . (For a definition of plane, see the entry for ASN.) 

Related Commands: ASN, DELKEYS, STOREYS 
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RCLMENU 

Recall Menu Number Command: Returns the menu number of the 

currently displayed menu. 



Level 1 


Level 1 




%enu 1 


Keyboard Access: 


f^niMODES) 


- %■i 


,V."I 


I P-i: : : : : : :: : 


i i I I I I ■ ! ■ 



Affected by Flags: None 


Remarks: ;r m enu has the form mm.pp, where mm is the menu 
number and pp is the page of the menu. See the MENU entry for a 
list of the HP 48 built-in menus and the corresponding menu numbers. 


Executing RCLMENU when the current menu is a user-defined menu 
(built by TMENU) returns 0.01 (in 2 Fix mode), indicating “Last 
menu”. 


Example: If the third page of the PRG DSPL menu is currently 
active, RCLMENU returns 13*03 (in 2 Fix mode). 

Related Commands: MENU, TMENU 


RCLZ 

Recall Sigma Command: Returns the current statistics matrix (the 

contents of reserved variable EDAT) from the current directory. 


Level 1 


Level 1 



Keyboard Access: 


S)(PLOT) (NXT) IP 



■ ■ ■ ■ - 


■ ■ " » P 




H 
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RCWS 




*i I III -1 



i n 



i r ■ i i i j j J i 


> B ... b P , 4414111 


r^ifpLQTi (nxt) mam © 


fflj (program entry mode) 


0(sw)SB Q— (program-entry mode) 

Affected by Flags: None 


Remarks: To recall EDAT from a parent directory (when ED AT 
doesn’t exist in the current directory), evaluate the name EDAT. 

Related Commands: CLE, STOE, E+, E- 


RCWS 

Recall WordSize Command: Returns the current wordsize in bits (1 

through 64). 


Level 1 



Level 1 


n 


Keyboard Access: [mth| |1 


.-ivl 


fT. ■ a ■ m a 



Affected by Flags: Binary Integer Wordsize (—5 through —10). 
Binary Integer Base (—11, —12) 

Related Commands: BIN, DEC, HEX, OCT, STWS 
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RDM 

Redlffiension Array Command: Rearranges the elements of the 

argument according to specified dimensions. 

Level 2 Level 1 Level 1 

[ vector ] x 
[ vector ] 

[[ matrix ]] 

[[ matrix ]] x 
' global 1 
' global ' 


{ ", 


eieme 


nts } 


{ "rows rn 

f ^elemef 


cols 


f "elements 1 
{ "rows m c o|s / 

{ "elements / 


{ "rows m cols f 


[ vector ] 2 
[[ matrix ]] 
[ vector ] 
[[ matrix ]] 7 


Keyboard Access: 



Affected by Flags: None 



Remarks: If the list contains a single number ^elements; the result 
is an n-element vector. If the list contains two numbers n rows and 

m cois> result is an n x m matrix. 


Elements taken from the argument vector or matrix preserve the 
same row order in the resulting vector or matrix. If the result is 
dimensioned to contain fewer elements than the argument vector or 
matrix, excess elements from the argument vector or matrix at the end 
of the row order are discarded. If the result is dimensioned to contain 
more elements than the argument vector or matrix, the additional 
elements in the result at the end of the row order are filled with zeros 
(( 0.. 0 > if the argument is complex). 

If the argument vector or matrix is specified by global , the result 
replaces the argument as the contents of the variable. 


Examples: [ 2 4 6 8 ] < 2 2 RDM returns [C241C 6 8 31 
[[ 2 3 4 ][ 1 6 9 3 3 S RDM returns C 2 3 4 1 6 9 0 0 3. 


Related Commands: TRN 
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Keyboard Access: (mthi(nxtiB p ; "** 


■ ■ _r ■ |i | 9'1 ' r I * * .. 1 ■ 9 ' I r P_* ' • i B 1_1 ■ - - -Ik I U 

‘ t- * |I | ■ 4 ■ iff » ’ ! " Bi^B 1 1 ■ 1 “ ■ ■ a a a ■ a a bp ■ ■ ■ - ■ ii ■ ■ * ■*■ ■ ■ *■*■■*■*. I*. ■ i 

- - . ■.-- ■ >1 ■.■ ■ ■ B aVTi --- - - - - p - + J- - - 


• k . ■ ■ ■ ,i . | 9 | m a . £ a a 


Affected by Flags: None 

Remarks: If the argument is 0, a random value based on the system 
clock is used as the seed. 

Related Commands: COMB, PERM, RAND,! 


RE 

Real Part Function: Returns the real part of the argument 


Level 1 


Level 1 


{} 


x_ unit 
(x, y) 

[ R-array ] 
[ C-array ] 
'symb' 


[ R-array ] 
[ R-array ] 
’RECsymbV 


Keyboard Access: [mthi[nxt 


» ■ I" H ■ 


Affected by Flags: Numerical Results (—3) 
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RE 


Remarks: If the argument is a vector or matrix, RE returns a 
real array, the elements of which are equal to the real parts of the 
corresponding elements of the argument array. 

Related Commands: C-+R, IM, R—C 


RECN 


Receive Renamed Object Command: 

Prepares the HP 48 to 

receive a file from another Kermit device 

and to store the file in a 

specified variable. 

{} 

Level 1 

Level 1 

' - ' - 

'name' —► 


"name" —► 



Keyboard Access: QQZcT) ( nxt] MU i 


Affected by Flags: I/O Device (—33), I/O Data Format (—35), 
RECV Overwrite (-36), I/O Messages (-39) 


When an HP 48 sends an object, it automatically appends a header 
that tells a receiving HP 48 whether to use ASCII or binary mode. 
Flag —35 has an effect only if this header is not present. 


Remarks: RECN is identical to RECV except that the name under 
which the received data is stored is specified in the stack. 

Related Commands: BAUD, CKSM, CLOSER), FINISH, KERRM, 
KGET, PARITY, RECV, SEND, SERVER, TRANSIO 
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RECV 


RECT 

Rectangular Mode Command: Sets Rectangular coordinate mode. 

Keyboard Access: 



Affected by Flags: None 

Remarks: RECT clears flags —15 and —16, and clears the R^Z and 
annuciators. 

In Rectangular mode, vectors are displayed as rectangular 
components. Therefore, a 3D vector would appear as [X Y Z], 

Related Commands: CYLIN, SPHERE 


RECV 


Receive Object Command: Instructs the HP 48 to look for a named 
file from another Kermit device. The received file is stored in a 
variable named by the sender. 


Keyboard Access: 




Affected by Flags: I/O Device (—33), I/O Data Format (—35), 
RECV Overwrite (—36), I/O Messages (—39) 


When an HP 48 sends an object, it automatically appends a header 
that tells a receiving HP 48 whether to use ASCII or binary mode. 
Flag —35 has an effect only if this header is not present. 


Remarks: Since the HP 48does not normally look for incoming 
Kermit files, you must use RECV to tell it to do so. 


Related Commands: BAUD, CKSM, FINISH, KGET, PARITY, 
RECN, SEND, SERVER, TRANSIO 
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REPEAT 

REPEAT Command: Starts loop clause in WHILE ... REPEAT 

END indefinite loop structure. 

See the WHILE entry for syntax information. 

Keyboard Access: (prcT) lilllil IllSlB 1111 1; 

ii i ■ ■ i n n ■ ■ ■ ■ ■ i ■I'll' . .. . . ai ■ ■ ■ 


Remarks: See the WHILE entry for more information. 

Related Commands: END. WHILE 


REPL 

Replace Command: Replaces a portion of the level 3 target obj< 

with the level 1 object, beginning at a position specified in level 2 


Level 3 


Level 2 


Level 1 


Level 1 


tf matrix ]] 2 


[ vector ] x 


{ list x 


a rg e 


t ) 


"string tar g et " 
£Fro/?t a rg et 

^target 

PICT 

PICT 


positio n 


[[ matrix ]] 2 


[[ matrix ]] x { n r0 w "column > H matrix]] 


"positio n 
"position 
"position 

{#" #m } 

0,y) 

{#/? #m} 

(x,y) 


[ vector ] 2 

{ list i } 

" string x 11 
grob 1 

grobt 

grob ± 
grob i 


[[ matrix ]] 3 
[[ matrix ]] 3 
[ vector ] 3 

{ ^" s Lesult -i 

' string rf . sun " 

grob rssu n 

grob resu]t 


Keyboard Access: 


CHARS 


prg i fliassi aiBiBi 


pRGi affliBBa iBupm 


Bias* ami 


aits 
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Affected by Flags: None 

Remarks: For arrays, ^position counts in row order. For matrices, 
^position specifies the new location of the upper left-hand element of 
the replacement matrix. 


For graphics objects, the upper left corner of grob x is positioned at 
the user-unit or pixel coordinates i x,y > or Z #n #rri >. From there, 
it overwrites a rectangular portion of grob tzrget or PICT. If grob x 
extends past ^ro6 target or PICT in either direction, it is truncated in 
that direction. If the specified coordinate is not on the target graphics 
object, the target graphics object does not change. 


Examples: ll 1 1 1 n l i 1 1 1 3 I X i 1 i 11 

6 [[ 2 2 3 [22]] REPL returns 
C[ 11 1 11 E 1221 3 [ 1221 ]]. 



R B C D E 




REPL returns t ft F G D E >. 


"RBCDE" 5 11 PT5 11 REPL returns ,, RBCDFG n . 

ERRSE PICT C®ii| # 5d # 5d BLANK NEC REPL replaces a portion 
of PICT with a 5 x 5 graphics object, each of whose pixels is on 
(dark), and whose upper left corner is positioned at <@ ? @> in PICT. 

Related Commands: CHR, GOR, GXOR, NUM, POS, SIZE, SUB 



Resolution Command: Specifies the resolution of mathematical and 

statistical plots, where the resolution is the interval between values of 
the independent variable used to generate the plot. 


{} 

Level 1 

-> Level 1 


"Interval 



te rva 1 




Keyboard Access: ® (plot) |ill| 



Command Reference 3-271 

























RES 

Affected by Flags: None 

Remarks: A real number «i n ter-va i specifies the interval in user units. 
A binary integer #w interval specifies the interval in pixels. 

The resolution is stored as the fourth item in PPAR, with default 
value 0. The interpretation of the default value is summarized in the 
following table. 


Plot Type 

Default Interval 

BAR 

10 pixels (bar width = 10 pixel columns) 

DIFFEQ 

unlimited: step size is not constrained 

FUNCTION 

1 pixel (plots a point in every column of pixels) 

CONIC 

1 pixel (plots a point in every column of pixels) 

TRUTH 

1 pixel (plots a point in every column of pixels) 

GRIDMAP 

RES does not apply 

HISTOGRAM 

10 pixels (bin width =10 pixel columns) 

PARAMETRIC 

[independent variable range in user units]/130 

PARSURFACE 

RES does not apply 

PCONTOUR 

RES does not apply 

POLAR 

2°, 2 grads, or tt/ 90 radians 

SCATTER 

RES does not apply 

SLOPEFIELD 

RES does not apply 

WIREFRAME 

RES does not apply 

YSLICE 

1 pixel (plots a point in every column of pixels) 


Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 
PCONTOUR, POLAR, SCATTER, SLOPEFIELD, TRUTH, 
WIREFRAME, YSLICE 
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RESTORE 


RESTORE 

Restore HOME Command: Replaces the current HOME directory 

with the specified backup copy (s 7i port * name backup ) previously 
created by ARCHIVE, 


{} 


Level 1 

—^ 

Level 1 

•^port '^^^backup 

- 


backup 




Keyboard Access: ^(memory) (nxt 1 fim 


Affected by Flags: None 


Remarks: The specified port number must be in the range 0 to 33. 
Ports 1 and 2 must be configured as independent RAM (see FREE). 

To restore a HOME directory that was saved on a remote system 
using :IO:name ARCHIVE, put the backup object itself on the stack 
and execute RESTORE. 


Example: To restore a HOME directory that was saved as the file 
AUGl on a remote system, execute ! fiUGl 1 SEND on the remote 
system, then execute the following on the HP 48: 

RECV 'fiUGl’ RCL RESTORE 

Related Commands: ARCHIVE 
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REVLIST 

Reverse List Commend: Reverses the order of the elements in a list. 



Affected by Flags: None 
Related Commands: TSORT 


RKF 

Solve for Initial Values (Runge-Kutta-Fehlberg) Command: 

Computes the solution to an initial value problem for a differential 
equation, using the Runge-Kutta-Fehlberg (4,5) method. 



Keyboard Access: P^lfsolv 

Affected by Flags: None 



Remarks: RKF solves y’(t)=f(t.y), where y(t 0 )—y 0 . The arguments 
and results are as follows: 
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■ { list } contains three items in this order: the independent (f) and 
solution ( y ) variables, and the right-hand side of the differential 
equation (or a variable where the expression is stored). 

■ £ t0 | sets the absolute error tolerance. If a list is used, the first value 
is the absolute error tolerance and the second value is the initial 
candidate step size. 

■ £ T fj na i specifies the final value of the independent variable. 

RKF repeatedly calls RKFSTEP as it steps from the initial value to 

*T fi n a I * 

Example: Solve the following initial value problem for y(8), given 

that y(Q) — 0: 


1. Store the independent variable’s initial value, 0, in T. 

2. Store the dependent variable’s initial value, 0, in Y. 

3. Store the expression, — 2 y 2 , in F. 

4. Enter a list containing these three items: £ T V F >. 

5. Enter the tolerance. Use estimated decimal place accuracy as a 
guideline for choosing a tolerance: 0.00001. 

6. Enter the final value for the independent variable: 8, 

The stack should look like this: 

£ T Y F y 


i“t 
i i 


7. Press ilKl!!. (The calculation takes a moment.) The variable T 
now contains 8, and Y now contains the value .123077277659. 


The actual answer is .123076923077, so the calculated answer has an 
error of approximately .00000035, well within the specified tolerance. 


Related Commands: RKFERR, RKFSTEP, RRK, RRKSTEP, 
RSBERR 
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RKFERR 

Error Estimate for Runge-Kutta-Fehlberg Method Command: 

Returns the absolute error estimate for a given step h when solving an 
initial value problem for a differential equation. 


Level 2 Level 1 -> Level 4 Level 3 Level 2 Level 1 

{list} h { list } h y delta error 


Keyboard Access: 


.mm i . .«■#.. hbMHM -■■■■■jp-i ■ ■» ■ i i«Hf ■ - ■ I ■ ■ .1 I 1 ■ I I ■ ■ 

solve i$mm 


Affected by Flags: None 


Remarks: The arguments and results are as follows 


■ { list } contains three items in this order: the independent (t) and 
solution (y) variables, and the right-hand side of the differential 
equation (or a variable where the expression is stored). 


u h is a real number that specifies the step. 


■ V delta displays the change in solution for the specified step. 

■ error displays the absolute error for that step. A zero error 
indicates that the Runge-Kutta-Fehlberg method failed and that 
Euler’s method was used instead. 


The absolute error is the absolute value of the estimated error for a 
scalar problem, and the row (infinity) norm of the estimated error 
vector for a vector problem. (The latter is a bound on the maximum 
error of any component of the solution.) 

Related Commands: RKF, RKFSTEP, RRK, RRKSTEP, RSBERR 
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RKFSTEP 


RKFSTEP 

Next Solution Step for RKF Command: Computes the next solution 

step (ft n ext) f° an initial value problem for a differential equation. 


Level 3 

Level 2 

Level 1 

■* Level 3 Level 2 Level 1 

{ Ust } 

x tol 

h 

f X tol ^next 


Keyboard Access: f+O fsoLVEl IBIBII 

Affected by Flags: None 

Remarks: The arguments and results are as follows: 

{ list } contains three items in this order: the independent (t) and 
solution (f) variables, and the right-hand side of the differential 
equation (or a variable where the expression is stored). 

x to{ sets the tolerance value. 

h specifies the initial candidate step. 

A next is the next candidate step. 

The independent and solution variables must have values stored 
in them. RKFSTEP steps these variables to the next point upon 
completion. 


Note that the actual step used by RKFSTEP will be less than the 
input value h if the global error tolerance is not satisfied by that value. 
If a stringent global error tolerance forces RKFSTEP to reduce its 
stepsize to the point that the Runge-Kutta-Fehlberg method fails, 
then RKFSTEP will use the Euler method to compute the next 
solution step and will consider the error tolerance satisfied. The 
Runge-Kutta-Fehlberg method will fail if the current independent 
variable is zero and the stepsize < 1.3 x 1G~ 498 or if the variable is 
nonzero and the stepsize is 1.3 x 10 10 times its magnitude. 

Related Commands: RKF, RKFERR, RRK. RRKSTEP, RSBERR 
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RL 

Rotate Left Command: Rotates a binary integer one bit to the left 


Level 1 


#« 


Level 1 


#n 


{} 



Keyboard Access: (jmth 




ppSP f isiXT 1 iifiPIll islpl 


Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 

Remarks: The leftmost bit of becomes the rightmost bit of #n 2 

Related Commands: RLB, RR, RRB 


RLB 

Rotate Left Byte Command: Rotates a binary integer one byte to 
the left. 



{} 


Level 1 

- Level 1 

#»i 

-+ #n 2 



Keyboard Access: (mthI flHH fl^H 1111111111I1B 

Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 

Remarks: The leftmost byte of #?&! becomes the rightmost byte of 
#rc 2 • RLB is equivalent to executing RL eight times. 

Related Commands: RL, RR, RRB 
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RND 


Round Function: Rounds an object to a specified number of decimal 
places or significant digits, or to fit the current display format. 


Level 2 


Level 1 


Level 1 


{} 


ro u n d 


*symb l 
1 sym£> 1 1 
[ array 1 ] 

X-unit 

x-unit 


' s y mb round' 


ro u n d 


1 sym& ro n nd 


ro u n d 


rou nd 


' s y mb round' 


'RNDCz.symb^^j)' 
'RND(sy/T?i>,n round )' 
‘RND(symb 1 ,symb round )' 

[ array 2 ] 
y_ unit 

' RND (x.unit,symb ro d )' 


Keyboard Access: [mth) ;H1H|1 (nxT) (nxt) jji|f 


Affected by Flags: Numerical Results (—3) 

Remarks: n round (or symb roun<i if flag —3 is set) controls how the 
level 2 argument is rounded, as follows: 


Ground OF S^772& roim( j 

Effect on level 2 Argument 

0 through 11 

— 1 through —11 

12 

Rounded to n decimal places. 

Rounded to n significant digits. 

Rounded to the current display format. 


For complex numbers and arrays, each real number element is 
rounded. For unit objects, the numerical part of the object is rounded. 

Examples: < 4.5792, 8, 1275 > 2 RND returns < 4■58 ,8.13 >. 

[ 2-34907 3-96351 2.73453 1 “2 RND returns [ 2.3 4 2.7 ]. 


Related Commands: TRNC 
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RNRM 

ROW Norm Command: Returns the row norm (infinity norm) of its 
argument array. 


{} 


Level 1 


Level 1 

[ array ] 

- 

^row norm 


Keyboard Access: (mth 
Affected by Flags: None 



Remarks: The row norm is the maximum (over all rows) of the sums 
of the absolute values of all elements in each row. For a vector, the 
row norm is the largest absolute value of any of its elements. 


Related Commands: CNRM, CROSS, DET, DOT 


ROLL 

Roll Objects Command: Moves the contents of a specified level 
to level X, and rolls upwards the portion of the stack beneath the 
specified level. 



Level n+1 ... Level 2 Level 1 


obj n ,., obj 1 


Level n ... Level 2 Level 1 


obj ^^ * - * obj\ 


obj , 



Keyboard Access: 


stack 1 ansi 


Affected by Flags: None 

Remarks: 3 ROLL is equivalent to ROT 


Related Commands: OVER, PICK, ROLLD, ROT, SWAP 
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ROLLD 

Roll Down Command: Moves the contents of level 1 to a specified 
level, and rolls downwards the portion of the stack beneath the 
specified level. 


Lvl n+1 .. 

. Lvl 2 Lvl 1 

- Lvl n 

Lvl n-1 .. 

. Lvl 1 

obj n ... 

obj 1 n 

obj 1 

obj n ... 

obj 2 


Keyboard Access: f «t! ( stack l Bi ll 


Affected by Flags: None 


Related Commands: OVER, PICK, ROLL, ROT, SWAP 


ROOT 

ROOt-Finder Command: Returns a real number z root that is a value 
of the specified variable global for which the specified program or 
algebraic object most nearly evaluates to zero or a local extremum. 


Level 3 


Level 2 


Level 1 


Level 1 


< program > 

1 global' 

guess 


*root 

< program > 

' global* 

{ guesses } 


x root 

' symb 1 

' global' 

guess 


x root 

'symb 1 

1 global* 

{ guesses } 

— 

x root 


Keyboard Access: Qk) (solve 1 HUB 



Affected by Flags: None 


Remarks: ROOT is the programmable form of the HP Solve 
application. 
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ROOT 


guess is an initial estimate of the solution* ROOT produces an error 
if it cannot find a solution, returning the message Bad Guess < as > 
if one or more of the guesses lie outside the domain of the equation, 
or returns the message Constant? if the equation returns the same 
value at every sample point. ROOT does not return interpretive 
messages when a root is found. 


ROT 

Rotate Objects Command: Rotates the first three obj ects on the 
stack, moving the object in level 3 to level 1. 


Level 3 

Level 2 

Level 1 

■* Level 3 

Level 2 

Level 1 

°bj 3 

obj 2 

obj 1 

■+ obj 2 

obj\ 

obj 3 


11 


Keyboard Access: f^Tlf stack l 
Affected by Flags: None 


Remarks: ROT is equivalent to 3 ROLL. 


Related Commands: OVER, PICK, ROLL, ROLLD, SWAP 


—>ROW 

Matrix to Rows Command: Transforms a matrix into a series of 
row vectors and returns the vectors and a row count, or transforms 
a vector into its elements and returns the elements and an element 
count. 
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ROW+ 

{} 


Level 1 

■+ Level n+1... 

Level 2 

Level 1 

[[ matrix ]] 

■+ [ vector ] rovv 1 

[ vector ]rown 

''rowcou n t 

[ vector] 

■+ element 

element^ 

^elementcou n t 


Keyboard Access: rgTffT iamW 




Affected by Flags: None 


Related Commands: -»COL, COL-+, ROW 


ROW+ 

Insert Row Command: Inserts an array into a matrix (or one or 
more numbers into a vector) at the position indicated by rc index , and 
returns the modified matrix (or vector). 


{} 


Level 3 

Level 2 

Level 1 

->• Level 1 


[[ matrix ]] x 

[ matrix ] 2 

^index 

■+ [[ matrix ]] 3 


[[ matrix ]] , 

[ vector ] row 

n index 

■+ [[ matrix ]] 2 


[ vector ] x 

"element 

n \ n d e x 

■+ [ vector ] 2 



Keyboard Access: (mtFD 1II111 ilfflli lliil 

^ a . r ■ r rl i - i ■ a a ■ ■ i - . ■ i i ■ i i | r ■ ■ * ■ § % |i 4 ■ ■ m. m , g. 1 |. ■ >1 ■ ■ 


Affected by Flags: None 


Remarks: The inserted array must have the same number of columns 
as the target array. 


n index is rounded to the nearest integer. The original array is 
redimensioned to include the new columns or elements, and the 
elements at and below the insertion point are shifted down. 

Related Commands: COL-, COL+, ROW-, RSWP 
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ROW- 

Delete Row Command: Deletes row n of a matrix (or element n of a 
vector), and returns the modified matrix (or vector) and the deleted 
row (or element). 


{} 


Level 2 

Level 1 

-f Level 2 

Level 1 

[[ matrix ]] x 

n r ow 

—► [[ matrix ]] 2 

[ vector ] row 

[ vector ] x 

n ele ment 

—► [ vector ] 2 

efement n 

Keyboard Access: 

f MTH 1 11 FT 

1 I I !■■■ II 111! ■ I ■ 11 11 ■■■■--“ - ■ ■ “ “ I . - - - t - ■ ■ -*** ■ » 1 ■ .<1 •) 1 1 I f ^ 1 Ml 1 1 1 1 1 1 1 S * - ■ ... 1 

1 1.v.v-v J.-M--a t i i v.\..v. O 1] 

1 -v.«S,v,v,V .".V.V.’.'j [■*!.. |... 1 LI j ■ ■.■■■. .-.hf .v,|,v J.-.1 1 f • .V 

■ ■» ' ■ ■ P i ’ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ | ■ | ,i .i P. -jp ■ Jr* -- r r r r ■ ' ' f f ■ " IP J.* ■ i 'll «■ ■■-■■■■■-- 

-t rl ■ i* ■ ■ ■ ■ ■ » H*' ■ •■■■ r ' Buns rf - - ■#“ ■■ -ffP” ■ amammmm-m-- 



Affected by Flags: None 

Remarks: n row or ^element is rounded to the nearest integer. 

Related Commands: COL-, COL+, ROW+, RSWP 


- Bin- ■■■ --- 1 ■ i ■ " ' - 11 ‘ ■ ~ -~ 

ROW—> 

ROWS to Matrix Command: Transforms a series of row vectors and 
a row count into a matrix containing those rows, or transforms a 
sequence of numbers and an element count into a vector with those 
numbers as elements. 


LeVel n _j_ l mmm 

Level 2 

Level 1 

Level 1 

[ vector ] rovv l 

[ vector ]row n 

^rowcount 

■+ [[ matrix ]] 

element 

element n 

^elementcount 

- [ vector ] column 


Keyboard Access: 


/ \ -jV. f 

fMTHl ill 


P 


.'.'W.VIW 




Affected by Flags: None 


Related Commands: —>COL, COL—►, —ROW 
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RRB 


RR 

Rotate Right Command: Rotates a binary integer one bit to the 
right. 


{} 


Level 1 

-► Level 1 


#«i 




Keyboard Access: fMTHl —f [nxt) i*8*I Hill 

S 5 . . . . ... . HT .. . 


Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 

Remarks: The rightmost bit of #ni becomes the leftmost bit of #n 2 . 

Related Commands: RL, RLB, RRB 


RRB 

Rotate Right Byte Command: Rotates a binary integer one byte to 

the right. 


{} 

Level 1 

-> Level 1 


#n 1 

-*■ #n 2 



Keyboard Access: 


fMTH) fNXT) 




Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12). 


Remarks: The rightmost byte of # 7 ^ becomes the leftmost byte of 
#rc 2 . RRB is equivalent to doing RR eight times. 


Related Commands: RL, RLB, RR 
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RREF 

Reduced Row Echelon Form Command: Converts a rectangular 

matrix to reduced row echelon form. 


{} 

Level 1 

■+ Level 1 


[[ matrix ]] A 

[[ matrix ]] R 



Keyboard Access: 


rMTHi mmm aiiiis 

■■■■■■.. I. . _ k ■ . . I. I 1L. . I | . . 



Affected by Flags: Singular Values (—54) 

Remarks: Converts a given matrix into reduced row echelon form. 
Since row echelon form is primarly used for studying systems of linear 
equations. REEF ignores very small pivots if system flag —54 is clear. 


Related Commands: LU 


RRK 

Solve for Initial Values (Rosenbrock, Runge-Kutta) Command: 

Computes the solution to an intial value problem for a differential 
equation with known partial derivatives. 


Level 3 

Level 2 

Level 1 

■+ Level 2 

Level 1 

{ list} 

x tol X T final 

■+ { list } 

X to 1 

{ list } 

{ x tol x hstep 1 

X T fi n a 1 

■+ { list } 

x tol 


Keyboard Access: 


SOLVE):!! 



Affected by Flags: None 



Remarks: RRK solves y’(t)=f(t,y), where y(t 0 )=y 0 . The arguments 
and results are as follows: 
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RRK 


■ { list } contains five items in this order: 

□ The independent variable (2). 

n The solution variable ( y ). 

□ The right-hand side of the differential equation (or a variable 
where the expression is stored). 

□ The partial derivative of y'(t) with respect to the solution 
variable) (or a variable where the expression is stored). 

a The partial derivative of y 1 (t) with respect to the independent 
variable (or a variable where the expression is stored). 

■ x tol sets the tolerance value. If a list is used, the first value is the 

tolerance and the second value is the initial candidate step size. 


■ ^Ttinai specifies the final value of the independent variable. 

RRK repeatedly calls RKFSTEP as it steps from from the initial value 

to X-f fj n a I * 

Example: Solve the following initial value problem for y(8), given 
that y(0) — 0: 

^ = (rhj - V = /<«’ y) 

The derivative of the function with respect to y (df /dy) is -4^, and 
the derivative of the function with respect to i (df fdt) is ■ 


1. 

2 . 

3 . 

4 . 

5 . 

6 . 

7 . 

8 . 


Store the independent variable’s initial value, 0, in T 
Store the dependent variable’s initial value, 0, in Y. 
Store the expression, ~ 2y 2 , in F. 


Store df /dy. -Ay , in FY. 
Store df/dt, in FT. 


Enter these five items in a list: C T Y F FY FT}. 

Enter the tolerance. Use estimated decimal place accuracy as a 
guideline for choosing a tolerance: 0.00001. 

Enter the final value for the independent variable: 8. 
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The stack should look like this: 


C T Y F Ft FT} 

n 0G001 

l” 

I l 


9. Press MB. (The calculation takes a moment.) The variable T 

ujuni..a>,-^ jjf 

now contains 8, and Y now contains the value .123077277659. 


The actual answer is ,123076923077, so the calculated answer has an 
error of approximately .00000035, well within the specified tolerance. 

Related Commands: RKF, RKFERR, RKFSTEP, RRKSTEP, 
RSBERR 


RRKSTEP 

Next Solution Step and Method (RKF or RRK) Command: 

Computes the next solution step (A next ) to an intial value problem for 
a differential equation, and displays the method used to arrive at that 
result. 


Lvl 4 Lvl 3 

Lvl 2 

Lvl 1 - 

- Lvl 4 Lvl 3 

Lvl 2 

Lvl 1 

o 

X 

.Jg 

w- 1 

h 

last 

{ list } x to( 

h 

"next 

current 


Keyboard Access: 


f^nfSOLVEl 




Affected by Flags: None 


Remarks: The arguments and results are as follows: 

■ ( list } contains five items in this order: 

□ The independent variable (t), 

□ The solution variable ( y ). 

□ The right-hand side of the differential equation (or a variable 
where the expression is stored). 

□ The partial derivative of y 1 (t) with respect to the solution 
variable) (or a variable where the expression is stored), 
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RRKSTEP 


□ The partial derivative of y'(t) with respect to the independent 
variable (or a variable where the expression is stored). 

■ x t0 | is the tolerance value. 

■ h specifies the initial candidate step. 

■ last specifies the last method used (RKF = 1 , RRK = 2). If this is 
the first time you are using RRKSTEP, enter 0. 

■ current displays the current method used to arrive at the next step, 

■ A next is the next candidate step. 

The independent and solution variables must have values stored 
in them. RRKSTEP steps these variables to the next point upon 
completion. 

Note that the actual step used by RRKSTEP will be less than the 
input value h if the global error tolerance is not satisfied by that 
value. If a stringent global error tolerance forces RRKSTEP to 
reduce its stepsize to the point that the Runge-Kutta-Fehlberg or 
Rosenbrock methods fails, then RRKSTEP will use the Euler method 
to compute the next solution step and will consider the error tolerance 
satisfied. The Rosenbrock method will fail if the current independent 
variable is zero and the stepsize < 2.5 x 10~ 499 or if the variable is 
nonzero and the stepsize is 2.5 x 10' 11 times its magnitude. The 
Runge-Kutta-Fehlberg method will fail if the current independent 
variable is zero and the stepsize < 1.3 x 10' 498 or if the variable is 
nonzero and the stepsize is 1.3 x 10" 10 times its magnitude. 

Related Commands: RKF, RKFERR, RKFSTEP, RRK, RSBERR 
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RSBERR 

Error Estimate for Rosenbrock Method Command: Returns 

an error estimate for a given step h when solving an initial values 
problem for a differential equation. 


Level 2 

Level 1 - 

■+ Level 4 

Level 3 

Level 2 Level 1 

{ Ast } 

h 

{ list } 

h 

JWa error 


Keyboard Access: l»T)( solve) HI 8I1IB1 


Affected by Flags: None 


Remarks: The arguments and results are as follows: 

■ { list } contains five items in this order: 

d The independent variable ( t ). 

□ The solution variable ( y ). 

□ The right-hand side of the differential equation (or a variable 
where the expression is stored). 

□ The partial derivative of y'(t) with respect to the solution 
variable) (or a variable where the expression is stored). 

□ The partial derivative of y 1 (t) with respect to the independent 
variable (or a variable where the expression is stored). 

■ A is a real number that specifies the initial step. 


■ V delta displays the change in solution. 

m error displays the absolute error for that step. The absolute error 
is the absolute value of the estimated error for a scalar problem, 
and the row (infinity) norm of the estimated error vector for a 
vector problem. (The latter is a bound on the maximum error of 
any component of the solution.) A zero error indicates that the 
Rosenbrock method failed and Euler’s method was used instead. 


Related Commands: RKF, RKFERR, RKFSTEP, RRK, RRKSTEP 
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RSD 


RSD 

Residual Command: Computes the residual B — AZ of the arrays B, 
A, and Z. 


{} 


Level 3 

Level 2 

Level 1 

- Level 1 

[ vector ] B 

[[ matrix ]] A 

[ vector ] z 

- [ vector ] B _ AZ 

[[ matrix ]] B 

[[ matrix ]] A 

[[ matrix ]] z 

- [[ matrix ]] B _ AZ 


Keyboard Access: (mthi lliiiil fNxTl HUB 

V .. . 

Affected by Flags: None 

Remarks: A, B, and Z are restricted as follows: 

■ A must be a matrix. 

The number of columns of A must equal the number of elements of 
Z if Z is a vector, or the number of rows of Z if Z is a matrix. 


■ The number of rows of A must equal the number of elements of B if 
B is a vector, or the number of rows of B if B is a matrix. 

■ B and Z must both be vectors or both be matrices. 


■ B and Z must have the same number of columns if they are 
matrices. 

RSD is typically used for computing a correction to Z. where Z has 
been obtained as an approximation to the solution X to the system of 
equations AX = B. 
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RSWP 


IlOW Swap Command: Swaps rows % and j of a matrix and returns 
the modified matrix, or swaps elements i and j of a vector and returns 
the modified vector. 


{} 



Keyboard Access: |mth 

Affected by Flags: None 




Remarks: Row numbers are rounded to the nearest integer. Vector 
arguments are treated as column vectors. 


Related Commands: C3WP, ROW-}-, ROW- 


R^B 

Real to Binary Command: Converts a positive real integer to its 

binary integer equivalent. 




Level 1 


Level 1 


#n 



Keyboard Access: (TvrnT) 




Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (-11, -12) 
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Remarks: For any value of n < the result is # 0. For any 
value of n > 1.844S744073SE19 (base 10), the result is 
# FFFFFFFFFFFFFFFF (base 16). 

Related Commands: B->R 


R—>C 



Real to Complex Command: Combines two real numbers or real 
arrays into a single complex number or complex array. 



o 

Level 2 

Level 1 

Level 1 

X 

y 

- (x,y) 

[ R-array 1 ] 

[ R-array 2 ] 

♦ [ C-array ] 


Keyboard Access: 


[prgI 


:i ■ .1 


mm 


fMXT) 

Vy 1 —^—# 


■ ■ ■ ■■ ■■■■■■■■ 

■■■■! 
|V/bV.V-V-V. 


(mthI (nxT) Hi 


■ !* 8 a rr re a ■ ■ ■ ■ ■ ; h ! 

kilim r ! 


J.. • • .-.v." 

■ ■ ■■■■■ - f - r r r r ■ • 

■.-.■.--.v.T.'i:/. .1. 


Affected by Flags: 



Remarks: The level 2 argument represents the real element(s) of 
the complex result. The level 1 argument represents the imaginary 
element(s) of the complex result. 

Array arguments must have the same dimensions. 

Related Commands: C^R, IM, RE 
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Radians to Degrees Function: Converts a real number expressed in 


radians to its equivalent in degrees. 





{> 

Level 1 — 

Level 1 


X —► 

(180/tt) X 


’symb 1 —► 

'R—+D(symb ) 1 



Keyboard Access: [mth 


warn [nxt 1 in xTi wmsm 


Affected by Flags: Numerical Results (—3) 

Remarks: This function operates independently of the angle mode. 

Related Commands: D— 


SAME 

Same Object Command: Compares two objects, and returns a true 
result (1) if they are identical, and a false result (0) if they are not. 


Level 2 

Level 1 

■+ Level 1 

obj ± 

obj 2 

■+ 0/1 



Keyboard Access: (prcT) ■Ill! fNXT 


■■ W-'J vlj’’ L'pliiiV.V.V 




Affected by Flags: None 

Remarks: SAME is identical in effect to == for all object types 
except algebraics, names, and some units. (For algebraics and names 
~ = returns an expression that can be evaluated to produce a test 
result based on numerical values.) 


Examples: t R B > <4?5> S 


returns 0. 
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SCALE 


{flBXBft.) SANE returns 0. 
"CRTS" "CRTS" SAME returns 1. 

Related Commands: TYPE, == 


SBRK 

Serial Break Command: Interrupts serial transmission or reception. 


Keyboard Access: 



■ I Kiiii i i.j 




M- 



■ • ■ OUUL9 ' 


r ' 

- • pq-i 1 ■ *■ 


11 


■ _ ■ I i . 1 


»* m r r * p r ■ « 


Affected by Flags: I/O Device (-33) 

Remarks: SBRK is typically used when a problem occurs in a serial 

data transmission. 


Related Commands: BUFLEN, SRECV, STIME, XMIT 


SCALE 

Scale Plot Command: Adjusts the first two parameters in PPAR , 

<Zmin 5 and <*max, 2/max >, so that z sca i e and 2/ sca)e are the 

new plot horizontal and vertical scales, and the center point doesn’t 
change. 


{} 


Level 2 

Level 1 

■+ Level 1 

*sca le 

■*sca Ie 

- 


Keyboard Access: f^n(PLOT) 1I1H11 flsixTl 



Affected by Flags: None 


Remarks: The scale in either direction is the number of user units 
per tick mark. The default scale in both directions is 1 user unit per 
tick mark. 
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SCALE 

Related Commands: AUTO, CENTR, *H, *W 


SCATRPLOT 


Draw Scatter Plot Command: Draws a scatterplot of y) data 

points from the specified columns of the current statistics matrix 
(reserved variable EDAT). 


Keyboard Access: 


f^TIfSTAT) 




Affected by Flags: None 


Remarks: The data columns plotted are specified by XOOL and 
YCOL, and are stored as the first two parameters in the reserved 
variable EPAR. If no data columns are specified, columns 1 
(independent) and 2 (dependent) are selected by default. The ^-axis is 
autosealed and the plot type is set to SCATTER. 


When SCATRPLOT is executed from a program, the resulting 
display does not persist unless PICTURE or PVIEW is subsequently 
executed. 


If PICTURE is subsequently executed, pressing fiHSKB in the Picture 
environment draws a line to fit the data using the currently specified 
statistical model. 


Example: The following program plots a scatter plot of the data in 
columns 3 and 4 of EDAT , draws a best fit line, and displays the plot: 


3 XCOL 4 YCOL SCRTRPLOT BESTFIT 2LINE STEQ 


FUNCTION DRRW 


# 0d # 0d 


PVIEW 


FREEZE 


•V 


Related Commands: BARPLOT, PICTURE, IIISTPLOT, PVIEW, 
SCLE, XCOL, YCOL 
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SCATTER 


SCATTER 


Scatter Plot Type Command: Sets the plot type to SCATTER. 


Keyboard Access: f^lf'PLOTl (nxt) llllli 


dr 


I i fl a !|r a a a 1 a 


t.lv.lv 


r *.. 



Affected by Flags: None 


Remarks: When the plot type is SCATTER, the DRAW command 

plots points by obtaining x and y coordinates from two columns of the 
current statistics matrix (reserved variable SDAT). The columns are 
specified by the first and second parameters in the reserved variable 
SPAR (using the XCOL and YCOL commands). The plotting 
parameters are specified in the reserved variable PPAR ) which has this 
form: 


£ <%i n? s/miiC* $nax ■■ indep res axes ptype depend } 

For plot type SCATTER, the elements of PPAR are used as follows: 

■ '^min 5 ^min ^ a complex number specifying the lower left corner 
of PICT (the lower left corner of the display range). The default 
value is < - 6»5 ? - 3 « 1 >. 


■ ‘dfnax, y max > is a complex number specifying the upper right 
corner of PICT (the upper right corner of the display range). The 


default value is 




4 


■ indep is a name specifying the independent variable. The default 
value of indep is X . 

■ res is not used. 


■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin, a list specifying the tick-mark annotation, and two 

strings specifying labels for the horizontal and vertical axes. The 
default value is < 0 ? 9 >. 

■ ptype is a command name specifying the plot type. Executing the 
command SCATTER places the name SCATTER in ptype. 

m depend is a name specifying the dependent variable. The default 
value is Y. 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 


Command Reference 3-297 



















SCATTER 

PCONTOUR, POLAR, SLOPEFIELD, TRUTH, WIREFRAME, 
YSLICE 


SCHUR 



Schur Decomposition of a Square Matrix Command: Returns the 

Schur decomposition of a square matrix. 



{} 

Level 1 

-*■ Level 2 

Level 1 

[[ matrix ]] A 

- [[ matrix ]] Q 

[[ matrix ]] T 


Keyboard Access: (mth) IIH*!■■Sillllli 

PBF i i i ■ i i i i i i i i i i i i i i i H ■ ^ in i tie - - i ii li I i I I I n n m n n i r "iff -1 i 


Affected by Flags: None 

Remarks: SCHUR decomposes A into two matrices Q and T : 

If A is a complex matrix, Q is a unitary matrix, and T is an 
upper-triangular matrix. 


■ If A is a real matrix, Q is an orthogonal matrix, and T is an upper 
quasi-triangular matrix (T is upper block triangular with 1 x 1 or 
2x2 diagonal blocks where the 2x2 blocks have complex conjugate 
eigenvalues). 

In either case, A = Qx T xTRN(Q). 

Related Commands: LQ, LU, QR, SVD, SVL, TRN 
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SOLE 


SCI 

Scientific Mode Command: Sets the number display format to 

Scientific mode, which displays one digit to the left of the fraction 
mark and n significant digits to the right. 


_ {} 

Level 1 -► Level 1 


n 


Keyboard Access: ® modes i«ibi isisii 


Affected by Flags: None 


Remarks: Scientific mode is equivalent to scientific notation using 
n + 1 significant digits, where 0 < n < 11. (Values for n outside this 
range are rounded to the nearest integer.) In Scientific mode, numbers 
are displayed and printed like this: 

(sign) mantissa E (sign) exponent 

w T here the mantissa has the form n.(n ... ) and has zero to 11 decimal 
places, and the exponent has one to three digits. 

Example: The number 103.6 in Scientific mode to four decimal 
places appears as 1,036QE2. 

Related Commands: ENG, FIX, STD 



Scale Sigma Command: Adjusts <z mjn , y m] „ > and (x max , */ max 

in PPAR so that a subsequent scatter plot exactly fills PICT . 

Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: When the plot type is SCATTER, the command AUTO 
incorporates the functions of SCLX. In addition, the command 
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SCLZ 


SCATRPLOT automatically executes AUTO to achieve the same 
result. SOLE is included in the HP 48 for compatibility with the HP 



Related Commands: AUTO, SCATRPLOT 


SCONJ 

Store Conjugate Command: Conjugates the contents of a named 

object. 


__ _ _ {} 

Level 1 -»• Level 1 


1 name' 


Keyboard Access: 


f«Tl[MEMORY| iHStl fNXT) ■111 

. . 


■ ■ i i I i i fr- 


Affected by Flags: None 


Remarks: The named object must be a number, an array, or an 
algebraic object. For information on conjugation, see CONJ. 

Related Commands: CONJ, SINV, SNEG 


SDEV 

Standard Deviation Command: Calculates the sample standard 

deviation of each of the m columns of coordinate values in the current 
statistics matrix (reserved variable EDAT). 


Level 1 


Level 1 


[ x 


sd e v l 


sdev 

x sdev2 *** x sdevm J 
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SEND 


Keyboard Access: 


S)dM)8«' 



Affected by Flags: None 



Remarks: SDEV returns a vector of m real numbers, or a single real 
number if m — 1 . The standard deviations (the square root of the 
variances) are computed using this formula: 



where z- { is the tth coordinate value in a column, x is the mean of the 
data in this column, and n is the number of data points. 


Related Commands: MAXE, MEAN, MINE, PSDEV, PVAR, TOT, 
VAR 


SEND 

Send Object Command: Sends a copy of the named objects to a 
Kermit device. 



Level 1 -> 

Level 1 


1 name ' —► 

{ name x ... name n } 

{{ na/7?e 0(d name nBW } name ... } —► 



Keyboard Access: 



Affected by Flags: I/O Device (—33), I/O Data Format (—35), I/O 
Messages (—39) 


If flag —35 is clear (ASCII transfer), the translation setting also has an 
effect. 


Remarks: Data is always sent from a local Kermit, but can be sent 
either to another local Kermit (which must execute RECV or RECN) 

or to a server Kermit . 


Command Reference 3-301 


















SEND 


To rename an object when sending it, include the old and new names 
in an embedded list. 

Examples: Executing -Ct HhH BBB 33 SEND sends the variable 
named AAA but changes its name to BBB. 

Executing *CC HHH BBB 3 CCC 3 SEND sends A A A as BBB and sends 
CCC under its own name. (If the new name is not legal on the HP 48, 
just enter it as a string.) 

Related Commands: BAUD, CLOSEIO, CKSM, FINISH, KERRM, 
KGET, PARITY, RECN, RECV, SERVER, TRANSIG 


SEQ 

Sequential Calculation Command: Returns a list of results 

generated by repeatedly executing obj ex e c using index over the range 
£ start to ar end , in increments of £ incr . 


{} 


Level 5 

Level 4 

Level 3 

Level 2 Level 1 - 

■+ Level 1 

^t>/exec 

index 

*sta rt 

*e n d x ‘\ n c r 

-4 { list } 


Keyboard Access: (prgI HI 





Affected by Flags: None 


Remarks: obj exec is nominally a program or algebraic object that is 
a function of index , but can actually be any object, index must be a 
global or local name. The remaining objects can be anything that will 
evaluate to real numbers. 


The action of SEQ for arbitrary inputs can be predicted exactly from 
this equivalent program: 

X start %end F OR index obj exec EVAE X incr STEP 71 4 LIST 

where n is the number of new objects left on the stack by the FOR ... 
STEP loop. Notice that index becomes a local variable regardless of 
its original type. 
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SERVER 


Example: ' n A 2' 1 n' 14 1 returns £ 1 4 9 16 >. 

Related Commands: DOSUBS, STREAM 

SERVER 

Server Mode Command: Selects Kermit Server mode. 

Keyboard Access: 



©© 

Affected by Flags: I/O Device (—33), I/O Data Format (—35), 
RECV Overwrite (—36), I/O Messages (—39) 

Remarks: A Kermit server (a Kermit device in Server mode) 
passively processes requests sent to it by the local Kermit. The server 
receives data in response to SEND, transmits data in response to 
KGET, terminates Server mode in response to FINISH or LOGOUT, 
and transmits a directory listing in response to a generic directory 
request. 

Server mode supports Kermit Host Command packets. This allows 
you, for instance, to use a PC to type into the HP 48’s command line. 
(This is especially convenient while testing programs.) Do this as 
follows: 

1. Set up the HP 48 for data transfer to a computer, as described in 
“Transferring Data Between the HP 48 and a Computer” in chapter 
27 of the HP 48 User’s Guide. 

2. Execute SERVER to set the HP 48 to Server mode. 

3. On the PC, type REMOTE HOST followed by up to 89 characters to 
be entered into the HP 48 command line. 

4. Press (Return! to transmit and execute the commands. The HP 48 
executes the transmitted commands, then sends back to the PC’s 
display the resulting contents of the stack as the HP 48 would 
normally display them. 
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SERVER 


If you use a PC to write programs for the HP 48, you should include 
the %%HP . „ „ H header in the program. See the discussion of ASCII 
mode in chapter 27 of the HP 48 User’s Guide. 

Related Commands: BAUD, CKSM, FINISH, KERRM, KGET, 
PARITY, PKT, RECN, RECV, SEND, TRANSIO 


SF 

Set Flag Command: Sets a specified user or system flag. 



Level 1 


Level 1 


n 


flagnum ber 



Keyboard Access: 



l| i l k ■ w k s ■ ■ rkn i■ ■ k “ ■ ■ ■ i 
!■_■■■■ ■ ft ■ J- ■ -r. ( . 


f NXT) { NXT ) 


HhflMODESl !iii 




Affected by Flags: None 



Remarks: User flags are numbered 1 through 64. System flags are 
numbered —1 through —64. See appendix C, ^System Flags,” for a 
listing of HP 48 system flags and their flag numbers. 

Related Commands: CF, PC?, FC?C, FS?, FS?C 
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SIDENS 


SHOW 

Show variable Command: Returns ' symb 2 ', which is equivalent to 

1 symb 1 1 except that all implicit references to a variable name are 
made explicit. 


Level 2 Level 1 ->• Level 1 

'symb 1 ' 'name' -*• 'symb 2 ' 

' symb { name 1 name 2 •■• } —*■ 'symb 2 ' 




Keyboard Access: HtUsymbolic] 

Affected by Flags: Numerical Results (—3) 

Remarks: If the level 1 argument is a list, SHOW evaluates all global 
variables in 1 symb t 1 not contained in the list. 

Example: If 7 is stored in C and 5 is stored in D, then 


1 w 


X—Y+2*C+3*D' i n Y > SHOW 


returns ' Y-Y+14+15'. 


Related Commands: COLCT, EXPAN, ISOL, QUAD 


SIDENS 

Silicon Intrinsic Density Command: Calculates the intrinsic density 

of silicon as a function of temperature, x T . 


{} 



Level 1 

- 

Level 1 


X™|" 


x density 


x_ unit 


x_i/cm 3 


1 symb 1 

- 

‘SIDENS(sy/T7lt>)' 
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t 


SIDENS 


Keyboard Access: f ^llEQ lib) ii!H Ill* 


Affected by Flags: Numerical Results (—3) 


Remarks: If x T is a unit object, it must reduce to a pure 
temperature, and the density is returned as a unit object with units of 
1 / cm 3 . 


If x T is a real number, its units are assumed to be K, and the density 
is returned as a real number with implied units of 1/cm 3 . 

*■ 

x T must be between 0 and 1685 K. 


SIGN 

Sign Function: Returns the sign of a real number argument, the sign 
of the numerical part of a unit object argument, or the unit vector in 
the direction of a complex number argument. 


{} 


Level 1 

- 

Level 1 

Z 1 

-► 


x_ unit 


X • 
sig n 

'symb' 

** 

'SIGN (symb)' 


Keyboard Access: 

fMTHj lllilll fNXT 1 llllllil (returns the sign of a number) 


fMTHl fNXT) iHHi (NXT) 
complex number) 

Affected by Flags: Numerical Results (—3) 


iBtii (returns the unit vector of a 

■ i -in ..i ■« r \ 


Remarks: For real number and unit object arguments, the sign is 
defined as +1 for positive arguments, —1 for negative arguments, and 
0 for argument 0. 

For a complex argument: 
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SIN 


SIGN(z + iy) = 



Examples: 32_ft SIGN returns i. 

( 1,1 > SIGN returns ( - 707 1 0678 11 87 ? -707106781187 >. 


Related Commands: ABS, MANT, XPON 


SIMU 


Simultaneous Plotting Command: Enables and disables 

simultaneous plotting. 


Keyboard Access: 


ploti fNXTi mmm isibsi 


Affected by Flags: Simultaneous Plotting (—28) 

Remarks: 111** changes to Ifilllf when flag -28 is enabled (and 

simultaneous plotting is enabled). 


If the calculator is in program entry mode, pressing the menu key 
echoes AXES, CNCT, and SIMU flag numbers to the command line. 
Pressing (±D or first echoes the flag numbers and SF or CF to the 
command line. 


Related Commands: AXES, CF, SF 


SIN 

Sine Analytic Function: Returns the sine of the argument. 


Level 1 


Level 1 

Z 

- 

sin Z 

1 symb' 

- 

'S\N(symb ) 1 

X-Unit s eg „ or 


sin (x_omt anguIar ) 
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Keyboard Access: fsfisD 


Affected by Flags: Numerical Results (—3), Angle Mode (—17, —18) 

Remarks: For real arguments, the current angle mode determines the 
number’s units, unless angular units are specified* 


For complex arguments, sin(^ + iy ) = sinx cosh?/ + i cosx sinh^/. 

If the argument lor SIN is a unit object, then the specified angular 
unit overrides the angle mode to determine the result. Integration and 
differentiation, on the other hand, always observe the angle mode. 
Therefore, to correctly integrate or differentiate expressions containing 
SIN with a unit object, the angle mode must be set to Radians (since 
this is a “neutral” mode). 

Related Commands: ASIN, COS, TAN 


SINH 

Hyperbolic Sine Analytic Function: Returns the hyperbolic sine of 

the argument. 



Level 1 


sinh z 

'S\U\-\(symb) 


Level 1 


symb 1 


Keyboard Access: 


fMTHl IWr" 



Affected by Flags: Numerical Results (—3) 


Remarks: For complex arguments. 
sinh(a; + iy) = sinhr cos y + i cosh# sin y. 


Related Commands: ASINH, COSH, TANK 


3-308 Command Reference 























SIZE 


SINV 


Store Inverse Command: 

variable with its inverse. 

Replaces the contents of the named 


{> 

Level 1 

-+ Level 1 

'name' —► 


Keyboard Access: Htjim 

emory i wmmw [nxt] mmrnm 

Affected by Flags: None 


Remarks: The named object must be a number, a matrix, an 
algebraic object, or a unit object. For information on reciprocals, see 

INV. 

Related Commands: INV. 

4 

SCONJ, SNEG 



Size Command: Returns the number of characters in a string, the 
number of elements in a list, the dimensions of an array, the number 
of objects in a unit object or algebraic object, or the dimensions of a 
graphics object. 
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SIZE 



Level 1 


Level 2 


Level 1 


"string" 

{ list } 

[ vector ] 
[[ matrix ]] 
'symb 1 
grob 
PICT 
x_ unit 


^width 

# n width 


{ n} 

{ n m } 


^ m height 

^ m height 


Keyboard Access: 



Affected by Flags: None 

Remarks: The size of a unit is computed as follows: the scalar (+1), 
the underscore (+1), each unit name (+1), operator or exponent (+1), 
and each prefix (+2). 

Any obj ect type not listed above returns a value of 1. 

Related Commands: CHR, NUM, POS, REPL, SUB 


SL 

Shift Left Command: Shifts a binary integer one bit to the left. 


Level 1 


Level 1 

#«2 
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SLB 


Keyboard Access: 



(MTH) 



Affected by Flags: Binary Integer Wordsize (—5 through -10), 
Binary Integer Base (—11, —12) 


Remarks: The most significant bit is shifted out to the left and lost, 
while the least significant bit is regenerated as a zero. SL is equivalent 
to binary multiplication by 2, truncated to the current wordsize. 


Related Commands: ASR, SLB, SR, SRB 


SLB 


Shift Left Byte Command: 

Shifts a binary integer one byte to the 

left. 

{> 

Level 1 

- Level 1 


* 



I t ►— 1 ‘■Mfe > - • MMflH 



. ■■ S i.tL&hfabfai, 




J ■ - ■». - I LJ LJ ■ 1 II ' J H 1 O. ■ ■ ■ iITTTa. I _ _ J ■ ■ p 

lr ■ 1 ■ 1 ■ * • e “ - i 


---*■» n i li m i li u i j n i ^ i i p 4 ji , ! .f 


Keyboard Access: fMTHl iHBsi ( nxt ] 18111 

& . . *. . . .* 

Affected by Flags: Binary Integer Wordsize (—5 through —10) 
Binary Integer Base (—11, —12) 


Remarks: The most significant byte is shifted out to the left and 
lost, while the least significant byte is regenerated as zero. SLB is 
equivalent to binary multiplication by 2 s (or executing SL eight 
times), truncated to the current wordsize. 

Related Commands: ASR, SL, SR, SRB 
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SLOPEFIELD 


SLOPEFIELD Plot Type Command: Sets the plot type to 
SLOPEFIELD. 


Keyboard Access: 0(ploT) (next! 
Affected by Flags: None 




Remarks: When plot type is set to SLOPEFIELD, the DRAW 

command plots a slope representation of a scalar function with two 
variables. SLOPEFIELD requires values in the reserved variables EQ } 

VPAR , and PPAR. 


VPAR has the following form: 


^left ^right 2/near 2/far ^low ^high ^min ^max V min 2/max ^eye 
2/eye ~eye ^step 2/step " 

For plot type SLOPEFIELD, the elements of VPAR are used as 
follows: 


■ a? reft and £ r j ght are real numbers that specify the width of the view 
space. 

■ 7 /near and are real numbers that specify the depth of the view 
space. 

■ Z\ Q w and z high are real numbers that specify the height of the view 

space. 

■ a: m1n and £ max are not used. 

■ y min and y max are not used, 

■ £ eye , 2/eye 5 and ^eye are real numbers that specify the point in 
space from which the graph is viewed. 

■ #step an d 2/step are real numbers that set the number of 
x-coordinates versus the number of y-coordinates plotted. 

The plotting parameters are specified in the reserved variable PPAR , 
which has this form: 

t ^min 3 2/min ,: -^max, 2 /max > indtp res axes ptype depend > 

For plot type SLOPEFIELD, the elements of PPAR are used as 
follows: 


in 3 V m i n 


is not used. 
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SNEG 


■ '^maX) V max I s not used. 

■ indep is a name specifying the independent variable. The default 
value of indep is X. 

■ res is not used. 

■ axes is not used. 

■ piype is a command name specifying the plot type. Executing the 
command SLOPEFIELD places the command name SLOPEFIELD 

in piype . 

■ depend is a name specifying the dependent variable. The default 
value is Y. 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 
PCONTOUR, POLAR, SCATTER, TRUTH, WIREFRAME, 
YSLICE 


SNEG 


Store Negate Command: 

its negative. 

Replaces the contents of a variable with 


{> 

Level 1 

-» Level 1 

’ name 1 -+ 


Keyboard Access: memory] JiitlJj 




Affected by Flags: None 


Remarks: The named object must be a number, an array, an 
algebraic object, a unit object, or a graphics object. For information 
on negation, see NEG. 

Related Commands: NEG, SCONJ, SINV 
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SNRM 


Spectral Norm Command: 

Returns the spectral norm of an array. 


{> 

Level 1 

-► Level 1 

[ array ] 

~^ *spect ra Inorm 


.■.'.Vl'. 

i 


.... i a i 

i 

MI& 



Keyboard Access: (mth! IS! 

Affected by Flags: None 

Remarks: The spectral norm of a vector is its Euclidean length, and 
is equal to the largest singular value of a matrix. 

Related Commands: ABS, CNRM, COND, RNRM, SRAD, TRACE 


SOLVEQN 

Start Equation Solver Command: Starts the appropriate solver for a 

specified set of equations. 


{} 


Level 3 

Level 2 

Level 1 

•> Level 1 

n 

m 

0/1 

- 


Keyboard Access: i^TUeq lib l fSHii 



Affected by Flags: Unit Type (60), Units Usage (61) 


Remarks: SOLVEQN sets up and starts the appropriate solver 
for the specified set of equations, bypassing the Equation Library 
catalogs. It sets EQ (and Mpar if more than one equation is being 
solved ), sets the unit options according to flags 60 and 61, and starts 
the appropriate solver. 
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SORT 


SOLVEQN uses subject and title numbers (levels 3 and 2) and a 
“PICT’ 5 option (level 1), and returns nothing. Subject and title 
numbers are listed in chapter 4, If the “PICT” option is 0, PICT is 
not affected; otherwise, the equation picture is copied into PICT . 

Related Commands: EQNLIB, MSOLVER 


SORT 

Ascending Order Sort Command: Sorts the elements in a list in 
ascending order. 


Level 1 

+ Level 1 

- 

{ Ust )i 




Keyboard Access: 




Affected by Flags: None 


Remarks: The elements in the list can be real numbers, strings, lists, 
names, binary integers, or unit objects. However, all elements in the 
list must all be of the same type. Strings and names are sorted by 
character code number. Lists of lists are sorted by the first element in 
each list. 


To sort in reverse order, use SORT REVLIST. 

Related Commands: REVLIST 
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SPHERE 


Spherical Mode Command: Sets Spherical coordinate mode. 

Keyboard Access: 


fMTHl mi® [NXT| 1*1111 

....ILL 

f^i modes) iiiiB inn 


Affected by Flags: None 

Remarks: SPHERE sets flags —15 and —16, and displays the 
annunciator. 

In Spherical mode, vectors are displayed as polar components. 
Therefore, a 313 vector would appear as [r A.6 £.<j> J. 

Related Commands: CYLIN, RECT 


SQ 

Square Analytic Function: Returns the square of the argument. 



Level 1 


Level 1 


z 

x_ unit 
[[ matrix ]] 
'symb 1 


z 2 

x 2 _ unit 2 

[[ matrix x matrix ]] 
*S Q(symb ) 1 


Keyboard Access: S)(2D 

Affected by Flags: Numerical Results (—3) 

Remarks: The square of a complex argument (#, y) is the complex 
number (x 2 — f 2 , 2 xy). 

Matrix arguments must be square. 

Related Commands: 
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SR AD 


SR 

Shift Right Command: Shifts a binary integer one bit to the right. 


{} 


Level 1 

■+ Level 1 


#»i 




Keyboard Access: 


fjTHj lillSS fNXTl ltiB 8 il l 

... ... 



Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (—11, —12) 


Remarks: The least significant bit is shifted out to the right and lost, 
while the most significant bit is regenerated as a zero. SR is equivalent 
to binary division by 2. 


Related Commands: ASR, SL, SLR, SRB 


SRAD 

Spectral Radius Command: Returns the spectral radius of a square 
matrix. 


{} 

Level 1 

-► Level 1 


[[ matrix ]] nx n 

_L V 

spectra (radius 


Keyboard Access: (mitT) I 

wmm norm wmmm 



Affected by Flags: None 

Remarks: The spectral radius of a matrix is a measure of the size of 
the matrix, and is equal to the absolute value of the largest eigenvalue 
of the matrix. 
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SR AD 

Related Commands: COND, SNRM, TRACE 


SRB 

Shift Right Byte Command: Shifts a binary integer one byte to the 

right. 


{} 


Level 1 

- 

Level 1 


#«1 

- 

#«2 



Keyboard Access: 


[MTH ] [NXT] 

.'. 




Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base (-11, -12) 


Remarks: The least significant byte is shifted out to the right and 
lost, while the most significant byte is regenerated as zero. SRB is 
equivalent to binary division by 2 s (or executing SR eight times). 


Related Commands: ASR, SL, SLB, SR 


SRECV 

Serial Receive Command: Reads up to n characters from the serial 
input buffer and returns them as a string, along with a digit indicating 
whether errors occurred. 


{} 


Level 1 

■+ Level 2 

Level 1 

n 

-+ ' string 1 

0/1 


Keyboard Access: SJQZS) fNxTI SH 
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SRECV 


Affected by Flags: I/O Device (-33) 

Remarks: SRECV does not use Kermit protocol. 


If n characters are not received within the time specified by STIME 
(default is 10 seconds), SRECV “times out”, returning a 0 to level 1 
and as many characters as were received to level 2. 

If the level 2 output from BUFLEN is used as the input for SRECV, 
SRECV will not have to wait for more characters to be received. 
Instead, it returns the characters already in the input buffer. 


If you want to accumulate bytes in the input buffer before executing 
SRECV, you must first open the port using OPENIO (if the port isn ? t 

already open). 

SRECV can detect three types of error when reading the input buffer: 


Framing errors and UART overruns (both causing "Receive 
Error ' 1 in ERRM). 

Inputbuffer overflows (causing "Receive But t er Overflow 

ERRM). 

Parity errors (causing "Parity Error" in 


H 


m 



SRECV returns 0 if an error is detected when reading the input 
buffer, or 1 if no error is detected. 


Parity errors do not stop data flow into the input buffer. However, if a 
parity error occurs, SRECV stops reading data after encountering a 
character with an error. 


Framing, overrun, and overflow errors cause all subsequently received 
characters to be ignored until the error is cleared. SRECV does not 
detect and clear any of these types of errors until it tries to read the 
byte where the error occurred. Since these three errors cause the byte 
where the error occurred and all subsequent bytes to be ignored, the 

input buffer will be empty after all previously received good bytes 
have been read. Therefore, SRECV detects and clears these errors 

when it tries to read a byte from an empty input buffer. 

Note that BUFLEN also clears the above-mentioned framing, overrun, 
and overflow errors. Therefore, SRECV cannot detect an input-buffer 
overflow after BUFLEN is executed, unless more characters were 
received after BUFLEN was executed (causing the input buffer to 
overflow again). SRECV also cannot detect framing and UART 
overrun errors cleared by BUFLEN. To find where the data error 
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SRECV 


occurred, save the number of characters returned by BUFLEN (which 
gives the number of “good 55 characters received), because as soon as 
the error is cleared, new characters can enter the input buffer. 

Example: If 10 good bytes were received followed by a framing error, 
then an SRECV command told to read 10 bytes would not indicate 
an error. Only when SRECV tries to read the byte that caused 
the framing error does it return a 0. Similarly, if the input buffer 
overflowed, SRECV would not indicate an error until it tried to read 
the first byte that was lost due to the overflow. 

Related Commands: BUFLEN, CLOSEIO, OPENIO, SBRK, 
STIME, XMIT 



Execute Program step Operation: Returns and executes the next 

step of a program. If the next step is a subroutine, executes the 
subroutine in a single step. 


Keyboard Access: fPRGl f nxt! HI 






i i ■ I ! I I I I • > 
i i i i I ! I • I I ■ 


Affected by Flags: None 


Remarks: SST is not programmable. 

Related Commands: NEXT (operation), SST| 


SSTl 

Execute Subroutine Step Operation: Returns and executes the 

next step of a program or subroutine. If the next step is a subroutine, 
returns and executes the first step of the subroutine. 


Keyboard Access: (prg) (nxt) MB— 



Affected by Flags: None 


Remarks: SSTl is not programmable. 

Related Commands: NEXT (operation), SST 
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START 


START 

START Definite Loop Structure Command: Begins START ... 

NEXT and START ... STEP definite loop structures. 


Level 2 

nan -■ 

START x start 

NEXT 

STEP 

STEP 


Level 1 


x f\ nish 

increment 
symb. n c re m e n t 



Level 1 


Keyboard Access: 







Affected by Flags: None 


Remarks: Definite loop structures execute a command or sequence of 
commands a specified number of times. 


■ START ... NEXT executes a portion of a program a specified 
number of times. The syntax is this: 


z$tart xfinish START loop-clause NEXT 

START takes two numbers (x start and jr flnish ) from the stack and 
stores them as the starting and ending values for a loop counter. 
Then the loop clause is executed. NEXT increments the counter by 
1 and tests to see if its value is less than or equal to £ flnish . If so, 
the loop clause is executed again. Notice that the loop clause is 
always executed at least once. 

■ START .,. STEP works just like START ... NEXT, except that it 

can use an increment value other than 1. The syntax is this: 

■T start finish ■- TART loop-cldUSe %incrernent oTEF 

START takes two numbers (# s tart an d ^finish) from the stack and 
stores them as the starting and ending values of the loop counter. 
Then the loop clause is executed. STEP takes ^increment from the 
stack and increments the counter by that value. If the argument of 
STEP is an algebraic or a name, it is automatically evaluated to a 
number. 
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START 


The increment value can be positive or negative: 

□ If positive, the loop is executed again when the counter is less 
than or equal to x fin]sh . 

n If negative, the loop is executed when the counter is greater than 
or equal to x fy ni£h * 

Related Commands: FOR, NEXT, STEP 



Standard Mode Command: Sets the number display format to 

Standard mode. 


Keyboard Access: (^THmodes) 

Affected by Flags: None 

Remarks: Executing STD has the same effect as clearing flags 
and —50. 




Standard format (ANSI Minimal BASIC Standard X3J2) produces the 

following results when displaying or printing a number: 

■ Numbers that can be represented exactly as integers with 12 or 
fewer digits are displayed without a fraction mark or exponent. Zero 
is displayed as 6. 

p" 

■ Numbers that can be represented exactly with 12 or fewer digits, 
but not as integers, are displayed with a fraction mark but no 
exponent. Leading zeros to the left of the fraction mark and trailing 
zeros to the right of the fraction mark are omitted. 

■ All other numbers are displayed in scientific notation (see SCI) with 
both a fraction mark (with one number to the left) and an exponent 
(of one to three digits). There are no leading or trailing zeros. 

In algebraic objects, integers less than ID 3 are always displayed in 

Standard mode. 


Example: The following table provides examples of numbers 
displayed in Standard mode: 
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STEP 


Number 

Displayed As 

Representable 

With 12 Digits? 

10 u 

1 00000000000 

Yes (integer) 

10 12 

1 - E 1 2 

No 

10- 11 

.000000000001 

Yes 

1.2 x lo -11 

1.23E-11 

No 

12.345 

1 ill a ■!' *4 3 

Yes 


Related Commands: ENG, FIX, SCI 


STEP 


STEP Command: Defines the increment (step) value, and ends 
definite loop structure. 


See the FOR and START command entries for syntax information 


Keyboard Access: 


fPRGl 


mm 

M 


i ■ ■ ■i -1.-. * ■ 

FI::- 

'Vi 


Irlir 



- 'i -i.ti.ppr 


- ■ - i ■ ■ ' 1 I B I I ■ ■ I 


fPRGl ^W — 

....- ...L..!,.!...-.. 




Remarks: See the FOR and START keyword entries for more 
information. 


Related Commands: FOR, NEXT, START 
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STEQ 

Store in EQ Command: Stores an object into the reserved variable 
EQ in the current directory. 


{} 


Level 1 

+ Level 1 


ohj 




Keyboard Access: This command must be typed in, but you can 
store an object in EQ with: 


Q(plot)(±D 


iHI 1 > >U>J 




[ PLOT) f NXT1 


Affected by Flags: None 




PliJ 


Related Commands: RCEQ 



STIME 

Serial Time-Out Command: Specifies the period that SRECV (serial 

reception) and XMIT (serial transmission) wait before timing out. 


{} 


Level 1 


Level 1 


secon d s 
0 


Keyboard Access: QO/o) flsixTI mil I11H 


Affected by Flags: None 


Remarks: The value for x is interpreted as a positive value from 0 to 
25.4 seconds. If no value is given, the default is 10 seconds. If x is 0 ; 


3-324 Command Reference 





































































there is no time-out; that is, the device waits indefinitely, which can 
drain the batteries. 

STIME is not used for Kerrnit time-out. 

Related Commands: BUFLEN, CLOSEIO, SBRK, SRECV, XMIT 


STO 

Store Command: Stores an object into a specified variable or object. 


_ _ {} 

Level 2 Level 1 -*■ Level 1 

obj 'name' 

grob PICT 

°bj ' n port ‘ name backup 

obj 1 name( index)' 

backup n pon 

library n pon 

library :n port :n |ibrary 


Keyboard Access: (stcT) 

Affected by Flags: None 

Remarks: Storing a graphics object into PICT makes it the current 
graphics object. 



To create a backup object, store the obj into the desired backup 
location (identified as s rc port s wame backup ). STO will not overwrite 
an existing backup object. 

To store backup objects and library objects, specify a port number (0 
through 33). Ports 1 and 2 must be configured as independent RAM, 
since backup and library objects can be stored only in independent 
RAM ( see the entry for FREE). 

To use a library object, the object must be in a port and it must 
be attached. A library object from an application card (ROM) is 


Command Reference 3-326 





STO 


automatically in a port (1 through 33), but a library object copied 
into RAM (such as through the PC Link) must be stored into a port 
using STO. 

After storing a library object in a port, it must then be attached to its 
directory before it can be used. To make a stored library “attachable”, 
turn the calculator off and then on. (See the entry for ATTACH.) 

This action (storing a library object, then turning the calculator off 
and on) also causes the calculator to perform a system halt, which 
clears the stack, the LAST stack, and all local variables, and returns 

the MATH menu to the display. 

■ 

STO can also replace a single element of an array or list stored in a 
variable. Specify the variable in level 1 as 3 name < index) ', which is a 
user function with index as the argument. The index can be n or n,m, 
where n specifies the row position in a vector or list, and n ? m specifies 
the row-and-column position in a matrix. 

Example: 1 fl+6+C+D 1 1 SUMflD 1 STO stores the expression 
A+B+C+D in the variable S UMAD . 



vector A. 


STO stores the integer 5 in the third element in a list or 


2 FK3? 5) 1 STO stores the integer 2 in the element in the third row 
and fifth column of matrix A. 


Related Commands: DEFINE, RCL, -► 


STOALARM 

Store Alarm Command: Stores an alarm in the system alarm list 

and returns its alarm index number. 


Level 1 -<■ Level 1 


*tim e ^index 

{date time} — " index 

{ date time oft/ actlon } -+ n index 


{ date time obj act]on 

x re peat } 
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STOF 


Keyboard Access: 


I— L ^HL | l naB l1BSIII *■ r B . L L I I M i PI PP' 

fTIME] fli [site 



Affected by Flags: Date Format (-42), Repeat Alarms Not 
Rescheduled (—43). Acknowledged Alarms Saved (—44) 


Remarks: If the argument is a real number r t imei the alarm date 
will be the current system date by default. 


If o6y action is a string, the alarm is an appointment alarm, and the 
string is the alarm message. If obj BCtion is any other object type, the 
alarm is a control alarm, and the object is executed when the alarm 
comes due. 


^repeat is the repeat interval for the alarm in clock ticks, where 8192 
clock ticks equals 1 second. 

n index is a real integer identifying the alarm based on its chronological 
position in the system alarm list. 

Example: With flag —42 clear, this command: 



1 i. 06 



30 RUN 491520 



sets a repeating control alarm for November 6 of the currently 
specified year, at 3:25:30 PM. The alarm action is to execute variable 
RUN . The repeat interval is 491520 clock ticks (1 minute). 

Related Commands: DELALARM, FINDALARM, RCLALARM 


STOF 

Store Flags Command: Sets the states of the system hags or the 

system and user flags. 



Level 1 

Level 1 


ste m 

{ ^ n system ^^user } 



Keyboard Access: 



MtHMODES] 



Affected by Flags: Binary Integer Wordsize (—5 through —10) 
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STOF 


The current wordsize must be 64 bits (the default wordsize) to store 
all flags. For example, executing STOF with a 32-bit binary integer 
stores only flags —1 through —32 and clears the other system flags. 

Remarks: With argument #n system , STOF sets the states 
of the system flags (—1 through —64) only. With argument 

■C #n system #n u$er >, STOF sets the states of both the system and user 
flags. 

A bit with value 1 sets the corresponding flag; a bit with value 0 
clears the corresponding flag. The rightmost (least significant) bit of 

^system and #^user correspond to the states of system flag —1 and 
user flag +1, respectively. If #n syste m or #n user contains fewer than 
64 bits, the unspecified most significant bits are taken to have value 0. 

STOF can preserve the states of flags before a program executes and 
changes the states. RCLF can then recall the flag’s states after the 
program is executed. 

Related Commands: RCLF 


STOKEYS 

Store Key Assignments Command: Defines multiple keys on the 

user keyboard by assigning objects to specified keys. 


Level 1 


Level 1 


{ obj 1 x keyi ... obj n X keyn } 

{ S obj 1 x keyl ... obj„ x keyn } 


1 I 


Keyboard Access: 


f^n iMODES) 




Affected by Flags: User-Mode Lock (—61) and User Mode (—62) 
affect the status of the user keyboard. 


Remarks: z key is a real number of the form rc.p specifying the key 
by its row number r, its column number c, and its plane (shift) p . 
(For a definition of plane, see the entry for ASN.) 
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STO+ 


The optional initial list parameter or argument S restores all keys 
without user assignments to their standard key assignments on 
the user keyboard. This is meaningful only when all standard key 
assignments had been suppressed (for the user keyboard) by the 

command l S* DELKEYS (see DELKEYS). 

If the argument obj is the name ' SKEY 1 , the specified key is restored 
to its standard key assignment. 

Related Commands: ASN, DELKEYS ? RCLKEYS 


STO+ 

Store Plus Command: Adds a number or other object to the 
contents of a specified variable. 


{} 


Level 2 

Level 1 

■+ Level 1 

obj 

'name 1 


'name 1 

obj 



Keyboard Access: (♦^[memory) RRIT H 



Affected by Flags: None 


Remarks: The object on the stack and the object in the variable 
must be suitable for addition to each other. STOT can add any 
combination of objects suitable for stack addition (see the entry for 

+)• 

Using STO+ to add two arrays (where obj is an array and name is the 
global name of an array) requires less memory than using the stack to 
add them. 


Related Commands: STO-, STO*, STO/, + 
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STO- 

Store MiOUS Commend: Calculates the difference between a number 
(or other object) and the contents of a specified variable, and stores 
the new value to the specified variable. 


{} 


Level 2 

Level 1 

->■ Level 1 

obj 

'name' 


'name 1 

obj 



Keyboard Access: (^ (memory) |ill|: 


Affected by Flags: None 



Remarks: The object on the stack and the object in the variable 
must be suitable for subtraction with each other. STO— can subtract 
any combination of objects suitable for stack subtraction (see the 
entry for —). 


Using STO— to subtract two arrays (where obj is an array and name 
is the global name of an array) requires less memory than using the 
stack to subtract them. 


Related Commands: STO+, STO*, STO/, - 


STO* 




Store Times Command: Multiplies 

variable by a number or other object. 

the contents of a specified 





{} 

Level 2 

Level 1 

Level 1 


obj 

'name' 



'name' 

obj 

- 
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STO / 


Keyboard Access: 
Affected by Flags: 



f^nfMEMORYt ai 

None 



Remarks: The object on the stack and the object in the variable 
must be suitable for multiplication with each other. When multiplying 
two arrays, the result depends on the order of the arguments. The 
new object of the named variable is the level 2 array times the level 1 
array. The arrays must be conformable for multiplication. 


Using STO* to multiply two arrays or to multiply a number and an 
array (where obj is an array or a number and name is the global name 
of an array) requires less memory than using the stack to multiply 
them. 


Related Commands: STO+, STO-, STO/, * 


STO/ 

Store Divide Command: Calculates the quotient of a number (or 

other object) and the contents of a specified variable, and stores the 
new value to the specified variable. 


{} 


Level 2 

Level 1 

-> Level t 


obj 

‘name' 

-> 


' name 1 

obj 




Keyboard Access: f+n memory) assaiiit mmam 

^ . ■ 

Affected by Flags: None 

Remarks: The new object of the specified variable is the level 2 
object divided by the level 1 object. 


The object on the stack and the object in the variable must be 
suitable for division with each other. If both objects are arrays, the 
divisor (level 1) must be a square matrix, and the dividend (level 2) 
must have the same number of columns as the divisor. 
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STO/ 

Using STO/ to divide one array by another array or to divide an array 
by a number (where obj is an array or a number and name is the 
global name of an array) requires less memory than using the stack to 
divide them. 

Related Commands: STO+, STO-, STO, / 


STOI 

Store Sigma Command: Stores obj in the reserved variable EDAT . 


{} 


Level 1 

- 

Level 1 1 

obj 

—r 



Keyboard Access: This command must be typed in, but you can 
store an object in EDAT with either of the following: 


S) (MI) iMD iiiiiii Q 



1 -^1-1 i^puv'i 1 1 

St .v:.! . 

*V4#I - 

mrnm 


H-il f STAT1 pit 1-11 (♦[) 111— 


- ii 


Affected by Flags: None 


Remarks: STQE accepts any object and stores it in EDAT . 
However, if the object is not a matrix or the name of a variable 

containing a matrix, an I rival id 2 Data error occurs upon 
subsequent execution of a statistics command. 

Related Commands: CLE, RCLE, E+, E- 
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STR 


STREAM 

Stream Execution Command: Moves the first two elements from the 

list onto the stack, and executes obj . Then moves the next element (if 
any) onto the stack, and executes obj again using the previous result 
and the new element. Repeats this until the list is exhausted, and 
returns the final result. 


Level 2 

Level 1 

■+ Level 1 

{ list } 

obj 

■+ result 


Keyboard Access: 



Affected by Flags: None 



Remarks: STREAM is nominally designed for obj to be a program 
or command that requires two arguments and returns one result. 


Examples: ■- 1 2 3 4 5 > STREAM returns 120 


STREAM is equivalent to 2LIST. 


Related Commands: DOSURS 


STR-* 

Evaluate String Command: Evaluates the text of a string as if the 

text were entered from the command line. 


Level 1 

"obj” 


Level t 

evaluated-object 



Keyboard Access: None. Must be typed in. 

Affected by Flags: None 
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STR—» 


Remarks: OBJ —* also includes this function. STR—> is included for 
compatibility with the HP 28S. 

Related Commands: ARRY-+, DTAG, EQ-+, LIST^, OBJ-+, 

—>STR 


-►STR 

Object to String Command: Converts any object to string form. 


Level 1 

■* Level 1 

obj 

-v "obj" 


Keyboard Access: 


(♦vHCHARS) fNXT) 




Affected by Flags: Binary Integer Wordsize (—5 through —10), 
Binary Integer Base ( — 11, —12), Number Display Format (—49, —50) 


Remarks: The full-precision internal form of a number is not 
necessarily represented in the result string. To ensure that —»STR 
preserves the full precision of a number, select Standard number 
display format or a wordsize of 64 bits (or both) before executing 



The result string includes the entire object, even if the displayed form 
of the object is too large to fit in the display. 

If the argument object is normally displayed in two or more lines, the 
result string will contain newline characters (character 10) at the end 
of each line. The newlines are displayed as the character m . 

If the argument object is already a string, —*STR returns the string. 

Example: —►STR can create special displays to label program output 
or provide prompts for input. The sequence 



1 DISP 1 FREEZE 
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STWS 


displays Result = object in line 1 of the display, where object is a 
string form of an object taken from level 1. 

Related Commands: -+ARRY, -^LIST, STR->, —>TAG, -*UNIT 


STWS 

Set Wordsize Command: Sets the current binary integer wordsize to 
n bits, where n is a value from 1 through 64 (the default is 64). 


{} 


Level 1 


Level 1 


n 


#n 


Keyboard Access: Imth) 111IHI [nxt! 



Affected by Flags: Binary Integer Wordsize (—5 through —10), 

Binary Integer Base (—11, —12) 


Remarks: Values of n less than 1 or greater than 64 are interpreted 
as 1 or 64, respectively. 


If the wordsize is smaller than an integer entered in the command 
line, then the most significant bits are not displayed upon entry. The 
truncated bits are still present internally (unless they exceed 64). but 
they are not used for calculations and they are lost when a command 
uses this binary integer as an argument. 

Results that exceed the given wordsize are also truncated to the 
wordsize. 


Related Commands: BIN, DEC, HEX, OCT, RCWS 
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SUB 

Subset Command: lleturns the portion of a string or list defined by 

specified positions, or returns the rectangular portion of a graphics 
object or PICT defined by two corner pixel coordinates. 


Level 3 


Level 2 


Level 1 


Level 1 


[[ matrix ]], n startposition 
[[ matrix ]] x {%,» n cokim „ } 

[[ matrix ^startposition 


end position 

end position 


{ n 


row 


col 


ii m n } 


[[matrix]]^ { n ro W ^column ) { rt row ^column ) 
“stnng ia r get" ^startposition ^end position 


{ list t 


a rge 


t ) 


grob^ a r g e t 
g rob target 


PICT 

PICT 


sta rt positio n 
n st a rt positio n 

{ #n, #m 1 } 

(x x , y,) 

{ #n 1 #m 1 } 

(x, , yi ) 


e nd position 

''e n d positio n 
{ &ri 2 #m 2 } 

(x 2 , y 2 ) 

■{ #n 2 ^n? 2 } 

(x 2 - y 2 ) 


[[ matrix ]] 2 
[[ matrix ]] 2 
[[ matrix ]] 2 
[[ matrix ]] 2 

’str/ng reS u it' 

{ "'^result > 


prob 


res u It 


^result 

S roto result 


grob 


res u It 


Keyboard Access: 



Affected by Flags: None 

Remarks. If ft en( j position less them Wg^art position? SUB returns an 
empty string or list. Values of n less than 1 are treated as 1; values of 
n exceeding the length of the string or list are treated as that length. 

For graphics objects, a user-unit coordinate less than the minimum 
user-unit coordinate of the graphics object is treated as that 
minimum. A pixel or user-unit coordinate greater than the maximum 
pixel or user-unit coordinate of the graphics object is treated as that 
maximum. 


Examples: 


C A B C D E 


2 4 SUB returns 


B C D 
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" ABODE" 0 10 SUE returns 
PICT C # 18 d # 20d > £ # 


"flBCDE", 
20d # 40d 


GRAPHIC 11 



SUB returns 


Related Commands: CHR, GOR, GXOR, NUM, POS, REPL, SIZE 


SVD 

Singular Value Decomposition Command: Returns the singular 

value decomposition of an m x n matrix. 


{} 


Level 1 -> 

Level 3 

Level 2 

Level 1 

[[ matrix ]] A 

[[ matrix ]] y 

[[ matrix ]] v 

t vector ] s 


Keyboard Access: 




Affected by Flags: None 


Remarks: SVD decomposes A into 2 matrices and a vector. U is an 
m x m orthogonal matrix. V is an nxn orthogonal matrix, and 5 is a 
real vector, such that A — U x diag(S) x V, S has length MIN(m,n) 
and contains the singular values of A in nonincreasing order. The 
matrix diag(S) is an mxn diagonal matrix containing the singular 
values S. 


The computed results should minimize (within computational 
precision): 

1 A-U • diag(5) • V\ 

min(m, n ) * |i4| 

where diag(5) denotes the mxn diagonal matrix containing the 
singular values S. 

Related Commands: DIAG—MIN, SVL 


Command Reference 3-337 













SVL 

Singular Values Command: Returns the singular values of an mxn 

matrix. 


{} 



Level 1 

- 

Level 1 


[[ matrix ]] 

- 

[ vector ] 


Keyboard Access: [mth 1 im m®! fKixTl 

^ . ..... " r " " 



.«li I i i"j ! i ij i 


Affected by Flags: None 


Remarks: SVL returns a real vector that contains the singular values 
of an mxn matrix in nonincreasing order. The vector has length 
MIN(m,n). 

Related Commands: MIN, SVD 


SWAP 

Swap Objects Command: Interchanges the first two objects on the 

st ack. 


Level 2 

Level 1 


Level 2 

Level 1 


obj\ 

obj 2 

- 

obj 7 

obj x 



Keyboard Access: Q) f swap ] 

Affected by Flags: None 

Related Commands: DUP, DUPN, DUP2, OVER, PICK, ROLL, 
ROLLD, ROT 
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%T 


SYSEVAL 

Evaluate System Object Command: Evaluates unnamed operating 

system objects specified by their memory addresses. 



Level 1 


Level 1 


#n 


add ress 


Keyboard Access: None. Must be typed in. 


Affected by Flags: None 

Remarks: Using SYSEVAL with random addresses can corrupt 
memory. 


Example: Display the version letter of an HP 48 by executing 
#30794h SYSEVAL . Version A, for example, would display 

"HPHP48-fl" . 


Related Commands: EVAL, LIBEVAL 


%T 

Percent Of Total Function: Returns the percent of the level 2 

argument that is represented by the level 1 argument. 
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%T 


Level 2 

Level 1 

X 

y 

X 

'symb' 

1 symb 1 

X 

'symb 1 1 

1 symb 2 * 

x_ unit 1 

y_ unit 7 

X-unit 

'symb 1 

'symb 1 

x_ unit 


Level 1 

1OOy/x 

'%T(x, symb )' 
^TCsymb, x) 1 
'%T(sym/b 1 , symb 7 ) 
1 00y_ unit 7 /x_ un/'ij 
'%T(x_Lfn/t, syrni))' 
'%T(sy/??/>, x_unit )' 



Keyboard Access: 



Affected by Flags: Numerical Results (—3) 


Remarks: If both arguments are unit objects, the units must be 
consistent with each other. 


The dimensions of a unit object are dropped from the result, but units 
are part of the calculation. 

For more information on using temperature units with arithmetic 
functions, refer to the entry for +. 

Example: 1 500_cm “«T returns 500, because 500 cm represents 

500% of 1 m. 


100JC 50_K “»T returns 5w. 

Related Commands: %, %CH 
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->TAG 

Stack to Tag Command: Combines objects in levels 1 and 2 to 

create tagged (labeled) object. 


Level 2 


Level 1 


Level 1 


obj 

obj 

obj 


"tag" 


'name 1 


.tag: obj 
.name: obj 
: x: obj 


Keyboard Access: [prgi milli 11*111 
Affected by Flags: None 

Remarks: The "tag" argument is a string of fewer than 256 

characters. 


Related Commands 

—►UNIT 


ARRY, DTAG, -►LIST, OBJ-s —►STR, 


TAIL 

Last Listed Elements Command: Returns all but the first element 

of a list or string. 


Level 1 


Level 1 

{ obj 1 ... obj„ } 


{ obj 2 ... obj„ } 

” string x ” 

-* 

” string 2 ” 


Keyboard Access: 
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TAIL 

Affected by Flags: None 

Example: "tali' 1 TAIL returns "all". 

Related Commands: HEAD 


TAN 

Tangent Analytic Function: Returns the tangent of the argument. 


{} 


Level 1 


Level 1 

Z 

-* 

tan z 

1 symb % 

- 

'TAN (symby 

x - un/t a n g u 1 a r 


tan (x_un/t angu|ar ) 


Keyboard Access: (Tm) 

Affected by Flags: Numerical Results (—3), Angle Mode (—17, 

— 18), Infinite Result Exception (—22) 

Remarks: For real arguments, the current angle mode determines 
the number’s interpretation as an angle, unless the angular units are 
specified. 


For a real argument that is an odd-integer multiple of 90 in Degrees 
mode, an Inf iniie Result exception occurs. If flag —22 is set (no 
error), the sign of the result (MAXR) matches that of the argument. 


For complex arguments, 


tan (x -f iy) 


(sin at) (cos x) + i(sinh y)(cosh y) 

sinh 2 y + cos 2 x 


If the argument for TAN is a unit object, then the specified angular 
unit overrides the angle mode to determine the result. Integration and 
differentiation, on the other hand, always observe the angle mode. 
Therefore, to correctly integrate or differentiate expressions containing 
TAN with a unit object, the angle mode must be set to Radians (since 
this is a “neutral” mode). 
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Related Commands: ATAN, COS, SIN 


TANH 

Hyperbolic Tangent Analytic Function: Returns the hyperbolic 

tangent of the argument. 


{} 

Level 1 

* Level 1 


z 

+ tanh z 


'symb 1 - 

♦ 'TANH (symb)' 




Keyboard Access: (Ivrml 1 

Affected by Flags: Numerical Results (—3) 
Remarks: For complex arguments , 


tanh (x + iy) 


sinh 2x + i sin 2 y 
cosh 2x + cos 2 y 


Related Commands: ATANH, COSH, SINH 


TAYLR 


Taylor’s Polynomial Command: Calculates the nth order Taylor’s 

polynomial of 1 symb 1 in the variable global. 



Level 3 Level 2 Level 1 -> 

Level 1 

'symb' 'global' n order ->■ 

'symb T ay.or' 


Keyboard Access: f+n [symbolic j 11MB 
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TAYLR 


Affected by Flags: None 

Remarks: The polynomial is calculated at the point global — 0 
(called a MacLaurin series). 


TAYLR always returns a symbolic result, regardless of the state of the 
Numeric Results flag (—3). 


Example: The command sequence 
returns 1 1 + ft*■ 2 -8 A 4 ! 1 . 


l+SI-NCX^S 1 


i >,-< i cr 


5ThYLR 


Related Commands: d, f, E 


TDELTA 

Temperature Delta Function: Calculates a temperature change. 


Level 2 

Level 1 

X 

y 

x^unitl 

y_ unit2 

x_ unit 

‘symb* 

'symb 1 

y_ unit 

x symb t 1 

} symb 2 1 



Level 1 

\l e11 a 

x-unit i delta 

‘TDELTA(x_ ur>it,symb )' 
'TDELTA(symb,y_ unit )' 
'TDELTA(symb t r symb 7 )' 



Keyboard Access: 


Q LIB 





Affected by Flags: Numerical Results (—3) 



Remarks: TDELTA subtracts two points on a temperature scale, 
yielding a temperature increment (not an actual temperature), x 
or X-unitl is the final temperature, and y or y^unit2 is the initial 
temperature. If unit objects are given, the increment is returned as a 
unit object with the same units as X-unitl . If real numbers are given, 
the increment is returned as a real number. 


Related Commands: TING 
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TEXT 


TEACH 

Teaching Examples Function: Creates an EXAMPLES (EXAM) 

subdirectory in the HOME directory and loads HP 48 programming 3 
graphing, and solver examples from ROM into it. 

Keyboard Access: None. Must be typed in. 

Affected by Flags: None 

Remarks: Items stored in the EXAMPLES subdirectory are deleted 
when CLTEACH is executed. 

Related Commands: CLTEACH 


TEXT 


Show Stack Display Command: Displays the stack display. 


Keyboard Access: 


fPRGlfNXT1 




Affected by Flags: None 


Remarks: TEXT switches from the graphics display to the stack 
display. TEXT does not update the stack display. 

Example: The command sequence DRAW 5 WRIT TEXT selects the 
graphics display and plots the contents of the reserved variable EQ (or 
reserved variable ED AT). It subsequently waits for 5 seconds, and 
then switches back from the graphics display to the stack display. 

Related Commands: PICTURE, FVIEW 
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THEN 

THEN Command: Starts the true-ciause in conditional or 
error-trapping structure. 

See the IF and IFERR entries for syntax information. 

Keyboard Access: 



Remarks: See the IF and IFERR entries for more information. 

Related Commands: CASE, ELSE, END, IF, IFERR 


TICKS 

Ticks Command: Returns the system time as a binary integer, in 

units of 1/8192 second. 


Level 1 


Level 1 


* n v 


m e 



Keyboard Access: (*tKtimb) IBHi 
Affected by Flags: None 

Remarks: TICKS enables elapsed time computations. 

Example: If the result from a previous invocation from TICKS is in 
level 1, then TICKS SNAP - B*R 8192 / returns a real number whose 
value is the elapsed time in seconds between the two invocations. 


Related Commands: TIME 
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TIME 

Time Command: Returns the system time in the form HH.MMSSs. 


Level 1 


Level 1 


time 


Keyboard Access: 




Affected by Flags: None 

Remarks: time has the form HH.MMSSs, where HH is hours, MM 
is minutes, SS is seconds, and s is zero or more digits (as many as 
allowed by the current display mode) representing fractional seconds. 
time is always returned in 24-hour format, regardless of the state of 
the Clock Format flag (—41). 


Related Commands: DATE, TICKS, TSTR 


-+TIME 

Set System Time Command: Sets the system time. 


{} 



Level 1 


Level 1 


time 


Keyboard Access: 
Affected by Flags: 



None 




Remarks: time must have the form HH.MMSSs, where HH is hours, 
MM is minutes, SS is seconds, and s is zero or more digits (as many 
as allowed by the current display mode) representing fractional 
seconds, time must use 24-hour format. 
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Example: 13. 3341 -»TIf1E sets the system time to 1:33:41 pm. 

Related Commands: CLKADJ, —DATE 


TINC 

Temperature Increment Command: Calculates a temperature 

increment. 


{} 


Level 2 Level 1 


Level 1 


^initial 

■Kdelta 

x_ unitl 

y unit 2 <i olta 

x^unit 

1 symb 1 

'symb 1 

y-umt delta 

t symb 1 ' 

'symb 2 ‘ 


*fi n a I 

x- unitl fl „ a , 
'TINC(x_unit,syn7b)' 

'TIN C( symb,y_ unit a e (t a )' 
'TINCCsymfcj ,symb 2 ')' 


Keyboard Access: 
Affected by Flags: 


f+rllEQ LIB 1 


BISS fNXTl lilili» 

i ■ i i dii i rrirri r “ ” “ r iri ----------p-P' 


Numerical Results (—3) 


Remarks: TINC adds a temperature increment (not an actual 
temperature) to a point on a temperature scale. Use a negative 
increment to subtract the increment from the temperature. Xinitial or 
x^unitl is the initial temperature, and y delta or y-unit2delta is the 
temperature increment. The returned temperature is the resulting 
final temperature. If unit objects are given, the final temperature 
is returned as a unit object with the same units as x-unitl . If real 
numbers are given, the final temperature is returned as a real number. 

Related Commands: TDELTA 
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TUNE 

Toggle Line Command: For each pixel along the line in PICT 

defined by the specified coordinates, TLINE turns off every pixel that 
is on, and turns on every pixel that is off. 


Level 2 

Level 1 -<■ 

Level 1 

(*i, yi) 

(x 2 , y 2 ) -► 


{ #n, i^m 1 } 

{ #n 2 #m 2 } -+ 


Keyboard Access: 

(PRG) PICT IIlfBl: 

m jK . “ *- *§■.■ - a nl' 1 - -1 ■ 1 ■ ■ i ■ . j n ■ ■ ■ ■ .jl eam.um.1. 


Affected by Flags: 

None 



Example: The following program toggles on and off 10 times the 
pixels on the line defined by user-unit coordinates (1*1 > and < 9 ? 9 >. 
Each state is maintained for .25 seconds. 


ERASE 6 18 XRNG 0 10 YNRG 


# 0d # 0d 


RVIEW 




1 10 START 
< 1 . 1 > < 3 , 
.25 WAIT 

NEXT 


TLINE 




Related Commands: ARC, BOX, LINE 
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TMENU 

Temporary Menu Command: Displays a built-in menu, library 
menu, or user-defined menu. 


Level 1 Level 1 

*m enu ~► 

{ tist^ e f| n i 1 1 0 n ) ~ i ' 

'redefinition 1 


Keyboard Access: f^liMODEsi llillll ■Bil 


Affected by Flags: None 


Remarks: TMENU works just like MENU, except for user-defined 
menus (specified by a list or by the name of a variable that contains 
a list). Such menus are displayed like a custom menu and work like 
a custom menu, but are not stored in reserved variable CST. Thus, 
a menu defined and displayed by TMENU cannot be redisplayed by 
evaluating CST. 


See the MENU entry for a list of the HP 48 built-in menus and the 

corresponding menu numbers (r menu ). 


Examples: 7 TMENU displays the first page of the MTH MATIt 
menu. 


48.. 92 TMENU displays the second page of the UNITS MASS menu, 

768 TMENU displays the first, page of commands in library 768. 

•f R 123 ,! HBC n > TMENU displays the custom menu defined by the list 
argument. 

1 MYMENU ' TMENU displays the custom menu defined by the name 
argument. 

Related Commands: MENU, RCLMENU 
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A 


TRACE 


TOT 

Total Command: Computes the sum of each of the m columns of 
coordinate values in the current statistics matrix (reserved variable 

SDAT). 


Level 1 


Level 1 


i ^suml *su 


^sum 


m2 * * * 


su m m 


] 


Keyboard Access: 



■«a*i 



Affected by Flags: None 

Remarks: The sums are returned as a vector of m real numbers, or 
as a single real number if m — 1. 

Related Commands: MAXS, MINS, MEAN, PSDEV, PVAR, 
SDEV, VAR 


TRACE 

Matrix Trace Command: Returns the trace of a square matrix. 


{} 

Level 1 

■+ Level 1 


[[matrix]] nxn 

*trace 



Keyboard Access: (mth) — B Biiail (nxt) HU 

V - ■! i • ■ ■ . 






'*■1 


■ ~ • T ■ jflj i 


u- 

- i fi ~II t t I i I i ■ 

IliJlilgil 


Affected by Flags: None 


Remarks: The trace of a square matrix is the sum of its diagonal 
elements. 
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TRANSIO 

I/O Translation Command: Specifies the character translation 
option. These translations affect only ASCII Kermit transfers and files 
printed to the serial port. 

_O 

Level 1 Level 1 

^option 


Keyboard Access: f^HfiTod 

Affected by Flags: None 





Remarks: Legal values for n are as follows: 


n 

Effect 

0 

No translation 

1 

Translate character 10 (line feed only) 
to/from characters 10 and 13 (line feed with 
carriage return, the Kermit protocol) (the 
default value) 

2 

Translate characters 128 through 159 (80 
through 9F hexadecimal) 

3 

Translate all characters (128 through 255) 


Related Commands: BAUD, CKSM, PARITY 
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TRN 

Transpose Matrix Command: Returns the (conjugate) transpose of 

a matrix. 

{} 

r 

Level 1 ->■ Level 1 

[[matrix]] — [[ matrix ]] transpose 

'name' —► 


Keyboard Access: (mthTI IHS1B 
Affected by Flags: None 



Remarks: TRN replaces an n x m matrix A with an m x n matrix 
A T , where: 

Ajj T — Aj j for real matrices 
Ajj T = CONJ(Ajj) for complex matrices 
If the matrix is specified by name, A T replaces A in name. 

Example: C C £ 3 1 3 C 4 6 9 ] 3 TRN returns 
[[ 2 4 3C 3 6 3C 1 9 3 3. 

Related Commands: CONJ 


TRNC 

Truncate Function: Truncates an object to a specified number of 
decimal places or significant digits, or to fit the current display format. 
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{} 


1 Level 2 

Level 1 

— 

■+ Level 1 

Z 1 

"truncate 

— 

+ z 2 

Z 1 

'symbtruncate' 

— 

+ ‘TRNCCzt r symb truncate )' 

'symbi 1 

"truncate 

— 

^ TRNC(sy/r?di ^truncate) 

l symb 1 1 

sym £> t r u nca te 

— 

■» ‘TRNCCsymbt ,symb truncate )' 

[ array ^ 

"truncate 

— 

+ [ array ] 2 

X-unit 

"truncate 

— 

* y _ unit 

X-unit 

* 

s y mb tru n ca te 

— 

■+ l TRNC(x_u/?/t f sym/> truncate ) 1 


Keyboard Access: 
Affected by Flags: 


fMTHl *111111! W1 fNxTI iliifc 


Numerical Results (—3) 


Remarks: ^truncate ( or 'symb trLincate ' if flag —3 is set) controls how 
the level 2 argument is truncated, as follows: 


^truncate 

Effect on Level 2 Argument 

0 through 11 

— 1 through — 11 

12 

truncated to n decimal places 

truncated to n significant digits 

truncated to the current display format 


For complex numbers and arrays, each real number element is 
truncated. For unit objects, the number part of the object is 
truncated. 


Examples: 

[ 2.34907 





O O 
c, 3 *_= 




> 2 TRNC returns 









Related Commands: RND 
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TRUTH 

Truth Plot Type Command: Sets the plot type to TRUTH. 


Keyboard Access: 


PLOT 


iMppP 


r ^ ii.ii ■ ■ ■ i 

'fliPH 

i ippl 1 ■ 4 ■ ■ • i C ■ i 'f - 


Affected by Flags: None 

Remarks: When the plot type is TRUTH, the DRAW command 

plots the current equation as a truth-valued function of two real 
variables. The current equation is specified in the reserved variable 
EQ. The plotting parameters are specified in the reserved variable 
PPAR , which has this form: 


'*• %min ? 


y m %n> tzmax? ymax? indep res axes ptype depend 


For plot type TRUTH, the elements of PPAR are used as follows: 

■ ,: *^m in ? in a complex number specifying the lower left corner 
of PICT (the lower left corner of the display range). The default 
value is < - 6 ■ 5 ? - 3« 1). 

■ c -£max j #max is a complex number specifying the upper right 
corner of PICT (the upper right corner of the display range). The 
default value is < 6 - 5 1 3 - 2 >. 


■ indep is a name specifying the independent variable on the 
horizontal axis, or a list containing such a name and two numbers 
specifying the minimum and maximum values for the independent 
variable (the horizontal plotting range). The default value is A. 

■ res is a real number specifying the interval (in user-unit 
coordinates) between plotted values of the independent variable on 
the horizontal axis, or a binary integer specifying that interval in 
pixels. The default value is 0, which specifies an interval of 1 pixel. 

■ axes is a list containing one or more of the following, in the order 
listed: a complex number specifying the user-unit coordinates of 
the plot origin, a list specifying the tick-mark annotation, and two 
strings specifying labels for the horizontal and vertical axes. The 
default value is < 0 ? 0 >. 


■ ptype is a command name specifying the plot type. Executing the 
command TRUTH places the name TRUTH in ptype , 

■ depend is a name specifying the independent variable on the vertical 
axis, or a list containing such a name and two numbers specifying 
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the minimum and maximum values for the independent variable on 
the vertical axis (the vertical plotting range). The default value is 

Y. 

The contents of EQ must be an expression or program, and cannot be 
an equation. It is evaluated for each pixel in the plot region. The 
minimum and maximum values of the independent variables (the 
plotting ranges) can be specified in mdep and depend ; otherwise, 
the values in O min , y m in > and (imax, y max) (the display range) 
are used. The result of each evaluation must be a real number. If 
the result is zero, the state of the pixel is unchanged. If the result is 
nonzero, the pixel is turned on (made dark). 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 
PCONTOUR, POLAR, SCATTER, SLOPEFIELD, WIREFRAME, 
YSLICE 


TSTR 


Dale and Time String Command: 

Returns a string derived from the 

date and time. 

{} 

Level 2 Level 1 -► 

Level 1 

date time —» 

" DOW DATE TIME' 


Keyboard Access: 


1 fNXTl f NXT ) 



Affected by Flags: Date Format (—42), Time Format (—41) 


Remarks: The string has the form "DOW DATE TIME", 
where DOW is a three-letter abbreviation of the day of the week 
corresponding to the argument date and time. DATE is the argument 
date in the current date format, and TIME is the argument time in 
the current time format. 


Example: With flags -42 and -41 clear, 2.061990 14 „ 55 TSTR 
returns "THE 02/06/90 02:55:00P", 
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Related Commands: DATE, TICKS, TIME 


TVARS 

Typed Variables Command: Lists ail global variables in the current 

directory that contain objects of the specified types. 


Level 1 

4 Level 1 


^ty p e ~ 

■+ { global ... 

> I 

{ ^ty pe ' " J ~ 

+ { global ... 

} 


Keyboard Access: f+rK memory) BiBBI Bill! 

^ .... 

Affected by Flags: None 

Remarks: If the current directory contains no variables of the 
specified types, TVARS returns an empty list. 


For a table of the object-type numbers, see the entry for TYPE. 

Related Commands: PVARS, TYPE, VARS 


TVM 


TVM Menu Command: Displays the TVM Solver menu. 


Keyboard Access: This command must be typed in, but you can 


also access the menu using f^lfSOLVE) 



Affected by Flags: None 


Related Commands: AMORT, TVMBEG, TVMEND, TVMROOT 
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TVMBEG 


Payment at Start of Period Command: Specifies that TVM 

calculations treat payments as being made at the begining of the 
compounding periods. 


Keyboard Access: This command must be typed in, but you can 
control begin/end mode with f*i)(SOLVE! §j 

Affected by Flags: None 


m 


ah ! h r w i *-p 


■_i i ■ ■ a i i I.-- 

...... 

|i ■ i i ■ il'il 


Related Commands: AMORT, TVM. TVMEND, TVMROOT 


TVMEND 


Payment at End of Period Command: Specifies that TVM 

calculations treat payments as being made at the end of the 
compounding periods. 


Keyboard Access: This command must be typed in, but you can 

control begin/end mode with SOLVE) llllflit llRSfill. 

Affected by Flags: None 


Related Commands: AMORT, TVM, TVMBEG, TVMROOT 


TVMROOT 

TVM Root Command: Solves for the specified TVM variable using 
values from the remaining TVM variables. 



a 

{} 

Level 1 

■+ Level 1 


, ' TVM variable 1 

X T V M variable 



Keyboard Access: f^DfsoLVEl 


■ rr----rLLr«i. i... ,irrp---" J - ,, -""iT i it i i i i i i i I I 

KpgS 


™pL,. 

f I '.v. r v. 

i ■ i ■ ■ i |h ■ k k|ib - -Cr ■ ■ - - r - - 


■ rii'iilll'lk 1 


I I 4 ! I 1 IS Pi P ■ 
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Affected by Flags: None 

Related Commands: AMORT, TVM, TVMBEG, TVMEND 


TYPE 


TYPE 

Type Command: Returns the type number of an object. 


Level 1 

-> Level 1 

obj 

"type 


Keyboard Access: 




(Wn (NXT) 



fPRGl M HHWB fNXTl 

.. ... . .. 


Affected by Flags: None 


Remarks: The following table lists object types and their type 
numbers. 


Object Type Numbers 


Object Type 

User Objects: 

Real number 
Complex number 
Character string 
Real array 
Complex array 
List 

Global name 
Local name 
Program 
Algebraic object 
Binary integer 


Number 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
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TYPE 


Object Type Numbers (continued) 


Object Type 

Number 

Graphics object 

ii 

Tagged object 

12 

Unit object 

13 

XLIB name 

14 

Directory 

15 

Library 

16 

Backup object 

17 

Built-in Commands: 


Built-in function 

18 

Built-in command 

19 

System Objects: 


System binary 

20 

Extended real 

21 

Extended complex 

22 

Linked array 

23 

Character 

24 

Code object 

25 

Library data 

26 

External object 

27-31 


The HP 28S TYPE command returns number 8 for built-in functions 
and built-in commands (HP 48 TYPE numbers 18 and 19). 

Related Commands: SAME, TVARS, VTYPE, == 


UBASE 

Convert to SI Base Units Function: Converts a unit object to SI 

base units. 
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UFACT 


{} 



Keyboard Access: 
Affected by Flags: 

Example: 38_knot 

Related Commands: 


r+ pfuNiTsi si iiai 

Numerical Results (—3) 

U B fl S E returns 15,4833333333_ m / s . 
CONVERT, UFACT, -+UNIT, UVAL 


UFACT 

Factor Unit Command: Factors the level 1 unit from the unit 
expression of the level 2 unit object. 


{} 



Level 2 

Level 1 

- 

Level 1 


x 1 _ unit 1 

x 2 -U/?/t 2 

- 

x 3 -unit 2 *unit 3 


Keyboard Access: f^lfuNiTsl mill 


Affected by Flags: None 

Remarks: UFACT is equivalent to this sequence: 



ROLLD OVER 


UBflSE 



Example: i_u 1_N UFRCT returns l_N*r*v's. 

Related Commands: CONVERT, URASE, ->UNIT. UVAL 
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—►UNIT 

Stack to Unit Object Command: Creates a unit object from a real 
number and the unit part of a unit object. 


Level 2 


Level 1 


y_ unit 


{} 


Level 1 


x_ 



Keyboard Access: 


prg I spipip «r 


'hH'immmi!!!!! 

■ 1 ■ I.. . | 1 " I M , . J I 


units! iffiiiir 


Affected by Flags: None 


Remarks: —►UNIT adds units to a real number, combining the 
number and the unit part of a unit object (the numerical part of the 
unit obiect is ignored). —►UNIT is the reverse of OBJ— applied to a 


unit object is ignored), 
unit object. 

Related Commands: 


ARRY, —►LIST, —STR, —TAG 


UNTIL 

UNTIL Command: Starts 

indefinite loop structure. 


-clause in a DO ... UNTIL ... END 


See the DO entry for syntax information. 


Keyboard Access: Iprg) :WSBM SffiSBi lilllll 

|F r r ■ b r ■ r r ■ * ■. a t ■ e ■ r q ■ * ■ p p • ini H ,H H • .■■■(« 


Remarks: See the DO entry for more information 

Related Commands DO, END 
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UPDIR 

Up Directory Command: Makes the parent of the current directory 
the new current directory. 

Keyboard Access: f»DfUFl 
Affected by Flags: None 

Remarks: UPDIR has no effect if the current directory is HOME. 

Related Commands: CRDIR, HOME, PATH, PGDIR 


UTPC 

Upper Chi-Square Distribution Command: Returns the probability 

utpc(n, x) that a chi-square random variable is greater than x , where 
n is the number of degrees of freedom of the distribution. 


{} 


Level 2 

Level 1 

Level 1 

rt 

X -+ 

utpc(n f x) I 

Keyboard Access: 

(MTU) (NXT 1 sBftiife? 

(NXT ) piPPSI 


Affected by Flags: None 

Remarks: The defining equations are these: 


■ For x > 0: 


utpc(n> x) = 



■ For x < 0: 

utpc(n , x) — 1 

For any value z, T — l)!, where ! is the HP 48 factorial 

command. 
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The value n is rounded to the nearest integer and, when rounded, 
must be positive. 

Related Commands: UTPF, UTPN, IJTPT 


UTPF 

Upper Snedecor’s F Distribution Command: Returns the 

probability utpf(n x , n 2 . x) that a Snedecor’s F random variable is 
greater than x , where n 1 and n 7 are the numerator and denominator 
degrees of freedom of the F distribution. 


{} 


Level 3 

Level 2 

Level 1 

- Level 1 

"l 

n 7 

X 

■+ utpf( L n 1 , n 7 , x) 



BS inxt) Si 

... 1 . .... 


Keyboard Access: imth) 

Affected by Flags: None 

Remarks: The defining equations for utpffn,, n 2 , x) are these: 


For x > 0 


71 


ni 

n 2 


F(n 1 


+n 2 


) 


r(¥)r(¥) 



oo 


t 


( n l ~ 2 ) 


if 


1 + 


ni 

n2 


t 


( n l +^2 ) 


dt 


u For x < 0: 


utpf(n ll n 2y x ) = 1 

For any value 2 , T where ! is the HP 48 factorial 

command. 

The values n 1 and n 2 are rounded to the nearest integers and, when 
rounded, must be positive. 

Related Commands: UTPC, UTPN, UTPT 
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UTPT 


UTPN 

Upper Normal Distribution Command: Returns the probability 

utpn(ra, v, x ) that a normal random variable is greater than x, where 
m and v are the mean and variance, respectively, of the normal 
distribution. 


{} 


Level 3 

Level 2 

Level 1 

■+ Level 1 

m 

V 

X 

■* utpn(m, v, x) 


Keyboard Access: (mth! fNxT) IHlill InxtI illlll 


Affected by Flags: None 

Remarks: For all x and m, and for v > 0, the defining equation is 
this: 


utpn(m 5 v . x) — 



For v — 0, UTPN returns 9 for x > m, and i for x < rn. 

Related Commands: UTPC ? UTPF, UTPT 


UTPT 

Upper Student’s t Distribution Command: Returns the probability 

utpt(n, z) that a Student’s t random variable is greater than z, where 
n is the number of degrees of freedom of the distribution. 


{} 


Level 2 

Level 1 

- 

Level 1 

n 

X 

- 

utpt(n f x) 


Keyboard Access: 
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UTPT 

Affected by Flags: None 

Remarks: The following is the defining equation for all x. 


utpt(n : x ) = 




For any value z, T (§) = (| — l)l, where ! is the HP 48 factorial 
command. 

The value n is rounded to the nearest integer and, when rounded, 
must be positive. 

Related Commands: UTPC, UTPF, UTPN 


UVAL 

Unit Value Function: Returns the numerical part of a 

unit object. 

UVAL 


Unit Value 

Function 


Level 1 

—, Level 1 



x_ unit 

' symb 1 

—♦ X 

-V ‘UVAL (symb)' 



Keyboard Access: f^Df units 1 


j-ivAp: 




Affected by Flags: Numerical Results (—3) 


Related Commands: CONVERT, UBASE, UFACT, —UNIT 
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VAR 

Variance Command: Calculates the sample variance of the 
coordinate values in each of the m columns in the current statistics 
matrix (L'DAT). 


Level 1 

- 

Level 1 



y 



va ria n ce 



t*variancel * * * x vanancem I 


Keyboard Access: 




Affected by Flags: None 


Remarks: The variance (equal to the square of the standard 
deviation) is returned as a vector of rn real numbers, or as a single real 
number if m — 1. The variances are computed using this formula: 



where X\ is the zth coordinate value in a column, x is the mean of the 
data in this column, and n is the number of data points. 


Related Commands: MAXE, MEAN, MINE, PSDEV, PVAR, 
SDEV, TOT 


VARS 

Variables Command: Returns a list of all variables’ names in the 
VAR menu (the current directory). 
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VARS 


Keyboard Access: 


Rt)(memory1 




Affected by Flags: None 


Related Commands: ORDER, PVARS, TVARS 


VERSION 

Software Version Command: Displays the software version and 

copyright message. 


Level 1 - 

Level 2 

Level 1 

— 

► ”version number" 

"copyright message" 


Keyboard Access: None. Must be typed in. 

Affected by Flags: None 


VTYPE 

Variable Type Command: Returns the type number of the object 

contained in the named variable. 



Level 1 -» Level 1 

'name' -* u type 

'^port • n3me backup ~^ *hype 

n port ■ ^library f "type 


Keyboard Access: 


fPRGd Ill igpg fNXTl fNXTl 811 

. " r .. 



Affected by Flags: None 
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Remarks: If the named variable does not exist, VTYPE returns —1. 
For a table of the objects’ type numbers, see the entry for TYPE. 

Related Commands: TYPE 


—>V2 

Stack to Vector/Complex Number Command: Converts two 

numbers from the stack into a 2-element vector or a complex number. 


{} 


Level 2 

Level 1 

■+ Level 1 

! X 

■ 

y 

- [*y] 

X 

y 

[ x -4-y ] 

X 

y 

-*■ (X, y) 

X 

y 

-* (x, 4-y) 


Keyboard Access: 





Affected by Flags: Complex Mode (—19), Coordinate System (—16) 


Remarks: The result returned depends on the setting of flags —16 
and and —19, as shown in the following table: 



Flag —19 clear 

Flag —19 set 

Flag —16 clear 
(Rectangular mode) 

[ x y] 

(x, y) 

Flag —16 set 
(Polar mode) 

[x 4-y ] 

(x, 4-y) 


Examples: With flag —19 clear, and flags —16 clear, 2 3 *V2 returns 

[ 23 3. 

With flag —19 set and flag —16 set (Polar/Spherical mode), 2 3 -+V2 
returns 
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Related Commands: V 



-*V3 

Stack to 3-Element Vector Command: Converts three numbers into 
a 3-element vector. 


{} 


Level 3 

Level 2 

Level 1 

■+ Level 1 

*1 

x 2 

x 3 

■* [ *i * 2 X 3 ] 

*1 

x t h e t a 

*z 

* [ *1 4- x theta *z ] 

*1 

x t h e t a 

X U ' 

phi 

[ X 1 ^" X theta ^ x phi 1 


Keyboard Access: 


fMTHl 




Affected by Flags: Coordinate System (—15 and —16) 

Remarks: The result returned depends on the coordinate mode used, 
as shown in the following table; 


Mode 

Result 

Rectangular 
(flag —16 clear) 

[ Xl x 2 x 3 ] 

Polar / Cylindrical 

(flag —15 clear and —16 set) 

[ Xj[ ] 

Polar/Spherical 
(flag —15 and —16 set) 

[ Xi X-4-theta ^-^-phi ] 


Examples: With flag —16 clear (Rectangular mode), I 2 3 V3 
returns [ 12 3]. 

With flag —15 clear and —16 set (Polar/Cylindrical mode), i 2 3 ->V3 
returns [ 1^2 3 3. 
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With flags -15 and —16 set (Polar/Spherical mode), 12 3 +V3 

returns [ 1 *£2 £% 3. 

Related Commands: V—►, —>V2 


Vector/Complex Number to Stack Command: Separates a vector or 

complex number into its component elements. 



Level 1 -» Level n .. Level 3 Level 2 Level 1 


[xy] 

1 Xr ^Lytheta I 

[ Xj. X 2 X 3 ] 

[ Xj ] 

l Xi ] 


[x 1 x 2 ... Xn ] 

(x, y) 

(x r , ^-y theta ) 



X 

y 

X r 

•^th eta 

x 2 

*3 

x t h e t a 

x z 

x theta 

x phi 

x n~l 

Xn 

X 

y 

X r 

■^th eta 


Keyboard Access: (mthi 






Affected by Flags: Coordinate System (—15 and —16) 


The elements of the argument complex number or vector are converted 

from their values in Rectangular mode (the form in which the complex 
number or vector is stored internally) to the current coordinate system 
mode before being returned to the stack. This means that the element 
values returned to the stack always match the displayed element values 
of the argument vector or complex number. 


Remarks: For vectors with four or more elements, V—► executes 
independently of the coordinate system mode, and always returns the 
elements of the vector to the stack as they are stored internally (in 
rectangular form). Thus, V—> is equivalent to OBJ—> for vectors with 
four or more elements. 
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Examples: With flag —16 clear (Rectangular mode), <2?3> V* 

returns 2 to level 2 and 3 to level 1. 


With flag —15 clear and flag —16 set (Polar/Cylindrical mode), 

C 2 &? 4 ] V* returns 2 to level 3, 7 to level 2, and 4 to level 1. 

C 9 7 5 3 1 V* returns 9 to level 4, 7 to level 3, 5 to level 2, and 3 to 
level 1, independent of the state of flags —15 and —16. 


Related Commands: 


V2, ->V3 


*w 


Multiply Width Command: 

•^factor • 

Multiplies a plot’s horizontal scale by 


{> 

Level 1 

- Level 1 

^factor 



Keyboard Access: 


f^niPLOTl 


fNXT) 



Affected by Flags: None 


Remarks: Executing *W changes the £-axis display range (x m]n and 
£ max in the reserved variable PPAR ). The plot center (the user-unit 
coordinate of the center pixel) does not change. 

Related Commands: AUTO, *H 5 XRNG 
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WAIT 


Wait Command: Suspends program execution for specified time, or 

until a key is pressed. 

{} 

Level 1 

■+ Level 1 

X 

1 

0 

■* X key 

-1 

' + x key 


Keyboard Access: 


fPRGl[NXT) 



Affected by Flags: None 

Remarks: The function of WAIT depends on the argument, as 

follows: 


■ Argument x interrupts program execution for x seconds. 

■ Argument 0 suspends program execution until a valid key is pressed 
(see below). WAIT then returns £ key , which defines where the 
pressed key is on the keyboard, and resumes program execution, 

£ key is a three-digit number that identifies a key’s location on the 
keyboard. See the entry for ASN for a description of the format of 

^ k 0 y * 

■ Argument —1 works as with argument 0, except that the currently 
specified menu is also displayed. 

S), ®, ©, ©G)> and are not by themselves valid keys. 

Arguments 0 or “1 do not affect the display, so that messages 
persist even though the keyboard is ready for input (FREEZE is not 
inquired). 

Normally, the MENU command does not update the menu keys 
until a program halts or ends. WAIT with argument —1 enables a 
previous execution of MENU to display that menu while the program 
is suspended for a key press. 
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Examples: This program: 


* t 


II o 


Press El] to addsPress any other key to subtract 


il 


1 DISP 0 WRIT IF 82.1 SAME THEN + ELSE 


END 


.V 


displays a prompting message and halts program execution until a key 
is pressed. If the (T) key (location 82.1) is pressed, two numbers on the 
stack are added. If any other key is pressed, two numbers on the stack 
are subtracted. 


This program: 


v. 


HDD 




y SUB 


> " 



J "Press [flDCO 


to add® Press [SUB] to subtract" 1 DISP -1 WRIT 


IF 11.1 SAME THEN + ELSE 


END 


i 


builds a custom menu with labels BBilH and and a 

prompting message. Executing -1 WRIT displays the custom menu 
(note that it ? s not active) and suspends execution for keyboard input. 


If the f||||||gB menu key (location 11.1) is pressed, two numbers on the 


stack are added. If any other key is pressed, two numbers on the stack 
are subtracted. 


Related Commands: KEY 


WHILE 

WHILE Indefinite Loop Structure Command: Starts the WHILE ... 

REPEAT ... END indefinite loop structure. 



Level 1 - 

Level 1 


WHILE 

REPEAT 

END 

T/F 

k 

y 

y 


Keyboard Access: 

Affected by Flags: 

fpp rl i pp kftLJs i,j p 



1 r l\\j I - LZ 1 n, . .1*i rl ,: t 

None 

L L. EH*. . 1 I— E 

■ ■ ■ ■ 1 ■ ■ ■ ■ ■ I ■ ■ ! 1 ■ ■ 1 I ■ « 1 181 IHH""**"*" ■** ■■■'"■ ■ 1 ■ ■ 

i- ■ ■■■■ r r iri ■ ■■■■■ ■ i i > i ■ 1 ■ ■ » i ■ i ■ - -J - «■ ■ * ■ ■■ - 
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WIREFRAME 


Remarks: WHILE ... REPEAT ... END repeatedly evaluates a test 
and executes a loop clause if the test is true. Since the test clause 
occurs before the loop-clause, the loop clause is never executed if the 
test is initially false. The syntax is this: 

WHILE test-clause REPEAT loop-clause END 

The test clause is executed and must return a test result to the stack. 
REPEAT takes the value from the stack. If the value is not zero, 
execution continues with the loop clause; otherwise, execution resumes 
following END. 

4 

Related Commands: DO, END, REPEAT 


WIREFRAME 

WIREFRAME Plot Type Command: Sets the plot type to 
WIREFRAME. 


Keyboard Access: 


f g)(PLOTlfNXTl 



Affected by Flags: None 


Remarks: When the plot type is set to WIREFRAME, the DRAW 

command plots a perspective view of the graph of a scalar function of 
two variables. WIREFRAME requires values in the reserved variables 
EQ, VPAR , and PPAR. 


VPAR has the following form: 

'■ ^left bright 2/near 2/far ^low ^high *^min ^max 2/rnin 3/max ^eye 
2/eye ^eye ^step 2/step 

For plot type WIREFRAME, the elements of VPAR are used as 
follows: 


■ £ )eft and £ r j ght are real numbers that specify the width of the view 
space, 

■ 2/near and 2/far are rea ^ numbers that specify the depth of the view 
space. 

■ z, ovv and igh are real numbers that specify the height of the view 
space. 
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WIREFRAME 


■ r min and # m3X are not used. 

■ ^ min and «/max are n°t used. 

■ #eye j y e ye , and z eyQ are real numbers that specify the point in 
space from which the graph is viewed. 

■ ^step and ^step are real numbers that set the number of 
x-coordinates versus the number of y-coordinates plotted. 

The plotting parameters are specified in the reserved variable PPAR, 
which has this form: 

£ <SFmini in > ^max, JT.inax) indep res axes ptype depend } 

For plot type WIREFRAME, the elements of PPAR are used as 

follows: 


■ ^ m in , in > is n °t used. 

■ <#max , #max > is not used. 

■ indtp is a name specifying the independent variable. The default 
value of indep is X . 

■ res is not used. 

■ axes is not used. 

■ ptype is a name specifying the plot type. Executing the command 

WIREFRAME places the command name WIREFRAME in ptype. 

u depend is a name specifying the dependent variable. The default 
value is Y. 

Related Commands: BAR, COMIC, DIFFEQ, FUNCTION, 
GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 
PCONTOUR, POLAR, SCATTER, SLOPEF1ELD, TRUTH, YSLICE 
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WSLOG 

Warmstart Log Command: Returns four strings recording the date, 

time, and cause of the four most recent warmstart events. 



Keyboard Access: None. Must be typed in. 

Affected by Flags: Date Format (—42) 

Remarks: Each string "log n n has the form M code-date time 
The following table summarizes the legal values of code and their 
meanings. 


Code 

, 

Description 

0 

The warmstart log was cleared by pressing (ONj(SPC) and 
then [ON 1 to wake the calculator up. (ONj(SPC) puts the 
HP 48 in “Coma mode” (very low power with the system 
clock stopped). Pressing fON ) then clears the log and 
warmstarts the system. 

i 

The interrupt system detected a very low battery 
condition at the battery contacts (not the same as a low 
system voltage), and put the calculator in a “Deep Sleep 
mode” ( with the system clock running). When (ONj is 
pressed after the battery voltage is restored, the system 
warmstarts and puts a 1 in the log. 

2 

Hardware failed during IR transmission (timeout). 

■■■ 

*i 

Run through address 0. 

■ 

4 

System time is corrupt. 

ri 

A Deep Sleep wakenp (for example, fON ), Alarm) 
detected no change to port status, but some changes in 
data on one or both cards. 
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Code 

Description 

6 

Unused. 

7 

A 5-nibble word (CMOS test word) in RAM was corrupt. 
(This word is checked on every interrupt, but it is used 
only as an indicator of potentially corrupt RAM.) 

8 

One of the following anomalies involving device 

configuration was detected: 

■ The interrupt system detected that one of the five 
devices was not configured. 

■ During a war ms tart, an unexpected device ID chain 
was encountered while attempting to configure 3 
(Portl, Port2, Xtra) of the 5 devices. 

m Same as previous, but detected during Deep Sleep 
wakeup. 

9 

The alarm list is corrupt. 

R 

Unused. 

1 

The card module was removed (or card bounce). 

r 
■ ■ 
iF* 

Hardware reset occurred (for example, an 
electrostatic-discharge or user reset). 

D 

An expected System (RPL) error handler was not found 
in runstream. 

E 

The configuration table is corrupt (bad checksum for 
table data). 

F 

The system RAM card was removed. 


The date and time stamp (date time) part of the log may he displayed 
as 90 - „ „ 0000 for one of three reasons: 

■ The system time was corrupt when the stamp was recorded. 

■ The date and time stamp itself is corrupt (bad checksum). 

■ Fewer than four warmstarts have occurred since the log was last 
cleared. 
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IX 2 


IX 

Slim of X- Values Command: Sums the values in the independent- 
variable column of the current statistical matrix (reserved variable 

SDAT). 


Level 1 


Level 1 


*su m 


Keyboard Access: f+ilfsTATl 



lull 



Affected by Flags: None 


Remarks: The independent-variable column is specified by XCOL 
and is stored as the first parameter in the reserved variable EPAR. 
The default independent-variable column number is 1. 


Related Commands: NE, XCOL, EX*Y, EX 2, EY, EY 2 


IX"2 

Sum of Squares of x-Values Command: Sums the squares of the 

values in the independent-variable column of the current statistical 
matrix (reserved variable EDAT). 


Level 1 Level 1 


*su m 


Keyboard Access: 


Q(M) 




Affected by Flags: None 


Remarks: The independent-variable column is specified by XCOL 
and is stored as the first parameter in the reserved variable EPAR. 
The default independent-variable column number is L 
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ZX 2 

Related Commands: NS, EX, XCOL, EX*Y, EY, EY'2 


XCOL 

Independent Column Command: Specifies the independent-variable 

column of the current statistics matrix (reserved variable EDAT). 


{} 


Level 1 

■+ Level 1 

"col 

"4* 


Keyboard Access: 


EKstat) 


i 

H-H 

■ - - - HH i - ■ • 

m ■ i ■ 9 

-v^l 

53 

ivI.V 


Affected by Flags: None 

Remarks: The independent"variable column number is stored as 
the first parameter in the reserved variable SPAR. The default 
independent-variable column number is 1. 


XCOL will accept a noninteger real number and store it in EPAR, but 
subsequent commands that utilize the XCOL specification in EPAR 
will cause an error. 


Related Commands: BARPLOT, BESTFIT, COLE, CORR, COV, 
EXPFIT, HISTPLOT, LIN FIT, LOGFIT, LR, PREDX, PREDY, 
PWRFIT, SCATRPLOT, YCOL 
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XMIT 

Serial Transmit Command: Sends a string serially without using 
Kermit protocol, and returns a single digit that indicates whether the 
transmission was successful. 


_ _ _ _ _ {} 

Level 1 -v Level 2 Level 1 

"string" —^ 1 

"string" -+ "substring unsent " 0 . 


Keyboard Access: 


r^n iwifNXTi 




Affected by Flags: I/O Device (-33) 

Remarks: XMIT is useful for communicating with non-Kermit 
devices such as RS-232 printers. 


If the transmission is successful, XMIT returns a 1. If the 
transmission is not successful, XMIT returns the unsent portion of the 
string and a 8. Use ERRM to get the error message. 

After receiving an XOFF command (with transmit pacing in the 
reserved variable IOPAR set), XMIT stops transmitting and waits 
for an XON command. XMIT resumes transmitting if an XON is 
received before the time-out set by STIME elapses; otherwise, XMIT 
terminates, returns a 8, and stores "Timeout" in ERRM. 

Related Commands: BUFLEN, SBRK, SRECV, STIME 


Command Reference 3-381 











XOR 

Exclusive OR Function: Returns the logical exclusive OR of two 
arguments. 


Level 2 

#«! 

"string^ " 
T/F 1 
T/F 
'symb' 
'symb 1 ' 


Level 1 


#n 2 

" string 2 " 

t/f 7 

'symb' 
T/F 
'symb 2 ' 


_{} 

Level 1 

* n 3 , 

"string 3 " 

0/1 

1 T/F XOR symb' 

'symb XOR T/F' 
symb 1 XOR symb 2 1 


Keyboard Access: 


[MTH1 SWSiS fNXTl 5940 R 1 : 

. .... ... 


fPRGl IHHM [NXT1 IlliP 


Affected by Flags: Numerical Results ( 
(—5 through —10) 




r Integer Wordsize 


Remarks: When the arguments are binary integers or strings. XOR 

does a bit-by-bit (base 2) logical comparison: 

■ Binary integer arguments are treated as sequences of bits with 
length equal to the current wordsize. Each bit in the result is 
determined by comparing the corresponding bits (bit i and bit 2 ) in 
the two arguments, as shown in the following table. 


bit i 

bii2 

bit! XOR bit 2 

0 ! 

0 

0 

0 

1 

1 

1 

0 

1 

1 

1 

0 
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■ String arguments are treated as sequences of bits, using 8 bits per 
character (that is, using the binary version of the character code). 
The two string arguments must be the same length. 

When the arguments are real numbers or symbolics, XOR simply 
does a true/false test. The result is i (true) if either, but not both, 
arguments are nonzero; it is 0 (false) if both arguments are nonzero or 
zero. This test is usually done to compare two test results. 

If either or both of the arguments are algebraic objects, then the result 
is an algebraic of the form 1 symb 1 XOR symb 2 '. Execute 4NUM (or 
set flag —3 before executing XOR) to produce a numeric result from 
the algebraic result. 

Related Commands: AND, NOT, OR 


XPON 

Exponent Function: Returns the exponent of the argument. 


{} 



Level 1 

---- 

■+ Level 1 


X 

^expon 


'symb' 

4 'XPON(syn 7 f>)' 


Keyboard Access: (mtFT) f HH (nxt) gP—j 

^ . . . . . 

Affected by Flags: Numerical Results (—3) 
Examples: 1»2E34 XPON returns 34. 


12.4E3 XPON returns 4. 


R* 1E34 X P 0N returns ' X P 0N < R* 1E34 > 


Related Commands: MANT, SIGN 
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XRECV 


XModem Receive Command: Prepares the HP 48 to receive an 
object via XModem. The received object is stored in the given 
variable name. 


Level 1 


'name' 


Level 1 


iiii 


Keyboard Access: QQ/cT) (nxtI IIIH 

Affected by Flags: I/O Device (-33), RECV Overwrite (-36) 

Remarks: The transfer will start more quickly if you start the 
XModem sender before executing XRECV, 

Invalid object names cause an error. If flag —36 is clear, object names 
that are already in use also cause an error. 

If you are transferring data between two HP 48s, executing 
-Cfifift BBE CCC 5 XRECV receives AAA, BBB, and CCC. You also 
need to use a list on the sending end (t RRR BBB CCC > HSEND, for 
example). 

Related Commands: BAUD, RECV, RECN, SEND, XSEND 


XRNG 

X-Axis Display Range Command: Specifies the z-axis display range. 


{} 


Level 2 

Level 1 

■+ Level 1 

X - 
m in 

*m ax 

1 


Keyboard Access: 


ir-iMIMI! 


PLOT! Wllilp- m ill- 
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XROOT 


Affected by Flags: None 

Remarks: The #-axis display range is stored in the reserved variable 
PPAR as £ mln and £ m ax m the complex numbers <z m1n , y m{n > and 
(a?max j Jfmax ■' * These complex numbers are the first two elements of 
PPAR and specify the coordinates of the lower left and upper right 
corners of the display ranges. 

The default values of £ min and r max are —6.5 and 6.5, respectively. 

Related Commands: AUTO, PDIM, PMAX, PMIN, YRNG 


XROOT 

Xth Root Of y Command: Computes the xth. root of a real number. 



Level 1 


Level 2 Level 1 


y 

X 

symb x ' 

' sym b 2 

'symb' 

X 

y 

'symb 

y_ unit 

X 

y_ unit 

l symb 


%/y 

‘XROOT (symb 2 r symb x )' 
'XROOT(x, symb ) 1 
'XROOT (symb, y)' 
tyy-unit 1 /* 

'XROOT {symb, y_ unity 


Keyboard Access: ffRfWl 

Affected by Flags: Numerical Results (—3) 

Remarks: Note that while the stack syntax is y x XROOT (the root 
is the second argument), the algebraic syntax is XROOT< x ? y ) (the 
root is the first argument) for consistency with the Equation Writer 
application. 

XROOT is equivalent to y 1 ' x , but with greater accuracy. 

If y < 0, x must be an integer. 

Related Commands: ' 
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XSEND 

XModem Send Command: Sends a copy of the named object via. 
XModem. 


Level 1 


'name' 


Level 1 



Keyboard Access: 



Affected by Flags: I/O Device (“33) 


Remarks: A receiving HP 48 must execute XRECV to receive an 
object via XModem. 


To start the transfer more quickly, start the receiving XModem after 
executing XSEND. Also, configuring the receiving modem not to do 
CRC checksums (if possible) will avoid a 30 to 60-second delay when 
starting the transfer. 


If you are transferring data between two HP 48s, executing 
•LflfiH BBB CCO XSEND sends AAA, BBB, and CCC. You also 
need to use a list on the receiving end (C HRfl BBB CCO XRECV, for 
example). 


Related Commands: BAUD, RECN, RECV, SEND, XRECV 


XVOL 

X Volume Coordinates Command: Sets the width of the view 


volume in the reserved variable VPAR. 






{} 

Level 2 

Level 1 -> 

Level 1 


x ieft 

x rlght 
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XXRNG 


Keyboard Access: (♦t)[plot] fNXT 1 
Affected by Flags: None 






Remarks: ar, eft and £ r j ght set the x-coordinates for the view volume 
used in 3D plots. These values are stored in the reserved variable 
VPAR. See appendix D, “Reserved Variables,” for more information 
about VPAR. 


Related Commands: EYEPT, XXRNG, YVOL, YYRNG, ZVOL 


XXRNG 

X Range of an Input Plane (Domain) Command: Specifies the x 

range of an input plane (domain) for GRIDMAP and PARSURFACE 

plots. 


{} 



Level 2 

Level 1 

- Level 1 


X - 

m in 

-*Vn ax 

-+ | 


Keyboard Access: 


(♦O('PLOT') fNXT) 




■vivjvlyjv 

. . * ■* ■ « ■ . M ■. ■■ > 

a • p m ■ » ■ ■ i ■ 

v.I.I 


• -■-» ri ■ a ri 


Affected by Flags: None 


Remarks: £ min and a: m3x are real numbers that set the 
x-coordinates for the input plane. These values are stored in the 
reserved variable VPAR, See appendix D, "Reserved Variables,” for 
more information about VPAR, 


Related Commands: EYEPT, NUMX, NUMY, XVOL, YVOL, 
YYRNG, ZVOL 
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IX*Y 

Sum Of X Times y Command: Sums the products of each of the 

corresponding values in the independent- and dependent-variable 
columns of the current statistical matrix (reserved variable E DAT) 


Level 1 


Level 1 


^sum 




Keyboard Access: Q(sw) 1111® 11III1 

Affected by Flags: None 

Remarks: The in depen dent-variable column is specified by XCOL 
and is stored as the first parameter in the reserved variable EPAR. 
The default independent-variable column number is 1. 

The dependent-variable column is specified by YCOL and is stored 
as the second parameter in reserved variable E PAR. The default 
dependent-variable column number is 2. 

Related Commands: NS, SX, XCOL, SX 2, SY, SY 2 


IY 

Sum Of y-Values Command: Sums the values in the dependent 

variable column of the current statistical matrix (reserved variable 

EDAT ). 



Level 1 


Level 1 


*s u m 


Keyboard Access: 


STATI IS 


'll'.’I 


Affected by Flags: None 


I I ! Ill I ■ I II9IKIII9;18 

■1""D ‘ I '’I -p 

■ 4 K ■ i» 1 

■ . Ipi ■ i vili ■■■■■■aei 

Vi" V.'. .LV.V.V.V.V 

tv 
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YCOL 


Remarks: The dependent variable column is specified by YCOL, and 
is stored as the second parameter in the reserved variable EPAR. The 
default dependent variable column number is 2. 

Related Commands: NS, EX, XCOL, EX*Y, SX"2, YCOL, SY~2 


IY~2 

Sum of Squares of y-Values Command: Sums the squares of the 

values in the dependent variable column of the current statistical 

matrix (reserved variable EDAT). 


Level 1 


Level 1 



^sum 


Keyboard Access: f^T) 1 'stat ) ||Bi|g 


~~m 


■ - h - 1 

-- L - . L ■ ' ■ ■ 1 ■ i i 


Affected by Flags: None 

Remarks: The dependent variable column is specified by YCOL. The 
default dependent variable column number is 2. 


Related Commands: NS, SX, XCOL, EX*Y, SX A 2, YCOL, SY 


YCOL 

Dependent Column Command: Specifies the dependent variable 
column of the current statistics matrix (reserved variable EDAT). 



Level 1 



Level 1 
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YCOL 


Keyboard Access: MtKstat] — 


■ ■ ■ i ■ * ■ r_r i■■ i j i 

.1 ft. .. |ll I . I - - - 


i ■ i . I j I l . i .. 

j i . i i ■ ii i t 


Affected by Flags: None 


Remarks: The dependent variable column number is stored as 
the second parameter in the reserved variable SPAR* The default 
dependent variable column number is 2. 


YCOL will accept a noninteger real number and store it in SPAR , but 
subsequent commands that utilize the YCOL specification in SPAR 
will cause an error. 


Related Commands: BARPLOT, BESTFIT, COLE, CORR, COV, 
EXPFIT, HISTPLOT, LINFIT, LOGFIT, LR, PREDX, PREDY, 
PWRFIT, SCATRPLOT, XCOL 


YRNG 

y-AxiS Display Range Command: Specifies the y -axis display range. 


{} 


Level 2 

Level 1 

- 

Level 1 

m i n 

Vm a x 

- 



Keyboard Access: 


r^nipLoT) 



Affected by Flags: None 

Remarks: The y -axis display range is stored in the reserved variable 
PPAR as y m \ n and y ma x in the complex numbers , t/ mjn and 

^max> Imax • These complex numbers are the first two elements of 
PPAR and specify the coordinates of the lower left and upper right 
corners of the display ranges. 


The default values of y m ]n and 2/ max are —3.1 and 3.2, respectively. 

Related Commands: AUTO, PDIM, PMAX, PMIN, XRNG 
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YSLICE 


YSLICE 


Y-Slice Plot Command: Sets the plot type to YSLICE. 


Keyboard Access: 



Affected by Flags: None 


1! VM - P r 
i 1 ■* ■* ■" ■‘I 

III 4 fi B i - r 
11 ■ “ - i 

■ i p . _ ■ - -i r 

■ niJr ■ r 


‘mvT?; r - i r, 

. ‘L 1 : irfl-T-pr#' 

-■-■-■-v.-.v 1 i p^ 

--. f , , ■ ■ , ■ r r r - ■ |-1. 1 >1 

.* - - p|. ipp r--ri- 1" 1 -- 

H 

1 ■ 1 | | ( 9 > ( | | | 1 | ■ i . , ■ 

j iM|i ■ ■ ifPi 

IBs 


Remarks: When plot type is set YSLICE, the DRAW command 
plots a slicing view of a scalar function of two variables. YSLICE 
requires values in the reserved variables EQ. VPAR , and PPAR. 


VPAR has the following form: 

bright ^near Viar ^low ^high ^min ^max Vmln Vvnax ^eye 
Ve ye ^eye ^step ^step - 1 ' 

For plot type YSLICE, the elements of VPAR are used as follows: 

■ x (eft and £ right are real numbers that specify the width of the view 
space. 


■ j/near and y lBr are real numbers that specify the depth of the view 
space. 

■ £ )ovv and z high are real numbers that specify the height of the view 

space. 

■ x min and £max are not used. 

■ j/ m]n and y max are not used. 

■ £ eye , ye , and are real numbers that specify the point in 
space from which the graph is viewed. 

■ #step determines the interval between plotted x-values within each 
“slice”, 


■ J/step determines the number of slices to draw. 

The plotting parameters are specified in the reserved variable PPAR ) 
which has this form: 

* ! - in j ^ min > ^max, ^max> indep res axes ptype depend } 

For plot type YSLICE, the elements of PPAR are used as follows: 

■ min j in > is not Used, 

■ <®max, Sfmax> IS not used. 
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YSLICE 


■ indep is a name specifying the independent variable. The default 
value of indep is X, 

m res is a real number specifying the interval, in user-unit coordinates, 
between plotted values of the independent variable; or a binary 
integer specifying the interval in pixels. The default value is 6, 
which specifies an interval of 1 pixel. 

■ axes is not used. 

■ ptype is a command name specifying the plot type. Executing the 
command YSLICE places YSLICE in ptype . 

■ depend is a name specifying the dependent variable. The default 
value is Y . 

Related Commands: BAR, CONIC, DIFFEQ, FUNCTION, 

GRIDMAP, HISTOGRAM, PARAMETRIC, PARSURFACE, 

PCONTOUR, POLAR, SCATTER, SLOPEFIELD, TRUTH, 

WIREFRAME 


YVOL 

Y Volume Coordinates Command: Sets the depth of the view 

volume in the reserved variable VPAR. 


{} 


Level 2 

Level 1 

-+ Level 1 

Yn ea r 

-^fa r - 



Keyboard Access: 


PLOT) fNXT) 




Affected by Flags: None 


Remarks: The variables ^ear and ^ far are real numbers that set the 
y-coordinates for the view volume used in 3D plots. y near must be less 
than ^ far . These values are stored in the reserved variable VPAR . 

Related Commands: EYEPT, XVOL, XXRNG, YYRNG, ZVOL 
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ZFACTOR 


YYRNG 

Y Range of an Input Plane (Domain) Command: Specifies the y 

range of an input plane (domain) for GRIDMAP and PARSURFACE 
plots. 


{} 


Level 2 

Level 1 

Level 1 


Yr\ ea r 

^fa r 




Keyboard Access: 


1+rifPLOT ) fNXTl 




Affected by Flags: None 


Remarks: The variables y v near and y y 1ar are real numbers that set 
the y-coordinates for the input plane. These values are stored in the 
reserved variable VPAR. 


Related Commands: EYEPT, XVOL, XXRNG, YVOL, ZVOL 


ZFACTOR 

Gas Compressibility Z Factor Function: Calculates the gas 

compressibility correction factor for nonideal behavior of a 
hydrocarbon gas. 



Level 2 


Level 1 


Level 1 


x Tr 

Q_ 

x Tr 

1 symb 

' symb 1 

Yp r 

symb 1 ' 

'symb 7 


X Z factor 

’ZFACTOR(x t r ,symb ) ’ 
l ZFACTOR(symfc,yp r )' 
'ZFACTORfsymfc! ,symb 2 )‘ 


Keyboard Access: 


(♦TKeq lib) 


I F II I *^t 



Command Reference 3-393 









































ZFACTOR 

Affected by Flags: Numerical Results (—3) 

Remarks: xp r is the reduced temperature: the ratio of the actual 
temperature (T) to the pseudocritical temperature ( T c ). (Calculate 
the ratio using absolute temperatures.) xp r must be between 1.05 and 

3.0. 

yp r is the reduced pressure: the ratio of the actual pressure (P) to the 
pseudocritical pressure (P c ). yp r must be between 0 and 30. 

xp r and yp r must be real numbers or unit objects that reduce to 
dimensionless numbers. 


ZVOL 

Z Volume Coordinates Command: Sets the height of the view 

volume in the reserved variable VPAR. 


{} 


Level 2 

Level 1 

Level 1 

x low 

x hig h 

- 


Keyboard Access: f^Tlf plot! InxTI 


! ■ I ■ 1 1 _ 9 ■ ' .< 4' ' " f i W r V 
.JJH.iJilSllliljT! d 


i 9 il 9 - aii-4-K-i 




- 1 • 


e-n 


■ ■ i| mm 9 ■ m ■ ■ 14 . ■■ ■ 1 d d 1 d d 4 d ■ 4 4-M i rH — r - - ->-• - 9 ■ ■ ■ 'I j ■ — 9 — - 9 >r - 


:ir vvSV r 

" ‘ * '44 ■ 


Affected by Flags: None 


Remarks: 


X 


low 


and x high are real numbers that set the z-coordinates 


for the view volume used in 3D plots. These values are stored in the 
reserved variable VPAR. 


Related Commands: EYEPT, XVOL, XXRNG, YVOL, YYRNG 
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+ 


+ 

Add Analytic Function: Returns the sum of the arguments. 


Level 2 Level 1 — Level 1 


[ array ] x 
z 

'symb' 
'symb 1 ' 

{ lis h } 

ofy A 

{ obj\ ... obj n } 
" string^' 
obj 

t! string" 

#"i 

x x _ unit 1 
1 symb ' 
x_ unit 
grob « 


z 2 

[ array ] 2 
'symb' 

z 

' sym t> 2 1 

{ > 

{ objj ... obj„ } 
obj A 

" string 2 " 

” string" 
obj 
n 2 

#n 2 

#/? 2 
y„ unit 2 

X„ i/17/t 

'sy/nd' 

grob 2 













z i + z 2 

[ array ] ^ ??2 

'z+(sy/77b)' 

'symb+z' 

'sy/r?^ d-syrnb 2 1 

f //s^ //st 2 } 

{ o£y A obj 1 ... obj n } 
f obj ^ , obj ft obj A 

" string 1 string 2 " 

" obj string ” 
"string obj" 

#n 3 

#/?3 

#«3 

(x 2 +y)-wn/t 2 

'symb+x.un/t' 

'x^u/i/t+sy^?^ 1 

£rrod 3 


Keyboard Access: £0 

Affected by Flags: Numerical Results (—3), Binary Integer Wordsize 
(—5 through —10) 

Remarks: The sum of a real number a and a complex number (x, y) 
is the complex number (x+a, y ). 

The sum of two complex numbers (x x , y x ) and (x 2 , y 2 ) is the 
complex number {x 1 +x 2) 2/i )* 
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The sum of a real array and a complex array is a complex array, where 
each element x of the real array is treated as a complex element {x, 0). 
The arrays must have the same dimensions. 

The sum of a binary integer and a real number is a binary integer that 
is the sum of the two arguments, truncated to the current wordsize. 
(The real number is converted to a binary integer before the addition.) 

The sum of two binary integers is truncated to the current binary 
integer wordsize. 

The sum of two unit objects is a unit object with the same dimensions 
as the level 1 argument. The units of the two arguments must be 
consistent. 


The sum of two graphics objects is the same as the result of 
performing a logical OR, except that the two graphics objects must 
have the same dimensions. 

Common usage is ambiguous about some units of temperature. When 
°C or °F represents a thermometer reading, then the temperature 
is a unit with an additive constant: 0 °C m 273.15 K, and 0 °F = 
459.67 °R. But when °C or °F represents a difference in thermometer 
readings, then the temperature is a unit with no additive constant: 1 

°C = 1 K and 1 °F = 1 °R. 

The calculator assumes that the simple temperature units x_°C and 
z_°F represent thermometer temperatures when used as arguments 
to the functions <, >, <, >, ==, and This means that, in 
order to do the calculation, the calculator will first convert any 
Celsius temperature to keIvins and any Fahrenheit temperature to 
Rankines. (For other functions or compound temperature units, such 

as x_°C r-iin , the calculator assumes temperature units represent 
temperature differences, so there is no additive constant involved, and 
hence no conversion.) 

The arithmetic operators +, —, %CH, and %T treat temperatures as 
differences, without any additive constant, but require both arguments 
to be either absolute (K and °R) } both °C, or both °F. No other 
combinations are allowed. 


Examples: 


1 2 3 > C FI e C > + returns I 1 2 3 R B C >. 


5jt # in + returns 69 in. 


CCQ 1 ][ 1 111 EE £1 It 111] + returns £[|1I 1 4 ]]. 
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FIRST 


I L 


SECOND' + returns ' FIRST+SECOND’. 


Related Commands: 




Subtract Analytic Function: Returns the difference of the arguments: 
the object in level 1 is subtracted from the object in level 2. 


Level 2 

% 

[ array R 
z 

'syrob 1 

1 symbi 1 

#f?i 

n i 

n i 

x L _ un/R 

! sy/7? b ' 
x_ unit 


Level 1 

[ array ] 2 
! symb ! 
z 

1 symb 2 1 
n 2 

#n 2 

#n 2 

y_un/t 2 

x_unit 

x symb' 


{} 

Level 1 

Zi -z 2 
[ array R _ 2 
'z-symb’ 

'sy/r?b-z s 
i symb 1 -symb 2 1 

#n 3 

#n 3 

(x 2 -y)_unit 2 
' symb—x^unit' 

' x^. unit-symb' 


Keyboard Access: Q 

Affected by Flags: Numerical Results (—3) 

Remarks: The difference of a real number a and a complex number 
(x ? f) is (x— a, y) or (a—x, — The difference of two complex 
numbers (ar x , y 1 ) and (x 2 , y 2 ) is (zi -x 2 , J/i — k )• 

The difference of a real array and a complex array is a complex array, 
where each element x of the real array is treated as a complex element 
(x, OR The two array arguments must have the same dimensions. 

The difference of a binary integer and a real number is a binary 
integer that is the sum of the level 2 number and the two’s 
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complement of the level 1 number. (The real number is converted to a 
binary integer before the subtraction.) 

The difference of two binary integers is a binary integer that is the 
sum of the level 2 number and the two’s complement of the level 1 
number. 

The difference of two unit objects is a unit object with the same 
dimensions as the level 1 object. The units of the two arguments must 
be consistent. 


Common usage is ambiguous about some units of temperature. 

When °C or °F represents a thermometer reading, then the 
temperature is a unit with an additive constant: 0 °C = 273.15 K 
and 0 °F = 459.67 °R. But when °C or °F represents a difference in 
thermometer readings, then the temperature is a unit w T ith no additive 
constant: 1 °C = 1 K and 1 °F = 1 °R. 


The calculator assumes that the simple temperature units r_“C and 
x _ 0 F represent thermometer temperatures when used as arguments 
to the functions <, >, <, >. ==, and This means that, in 
order to do the calculation, the calculator will first convert any 
Celsius temperature to kelvins and any Fahrenheit temperature to 
Rankines. (For other functions or compound temperature units, such 
as x_°C ■■■■'in, the calculator assumes temperature units represent 
temperature differences, so there is no additive constant involved, and 
hence no conversion.) 

The arithmetic operators T, —, %C 11, and %T treat temperatures as 
differences, without any additive constant, but require both arguments 
to be either absolute (K and °R), both °C, or both °F. No other 
combinations are allowed. 


Example: i5„ii 8_in - returns 292_in. 

[[51 If 3 1 J] [[21 ] [ 0 1 ] 1 - returns [ t 3 0 
1 TOTAL 1 1 PART 1 - returns ' TOTAL-PART 1 . 

Related Commands: +,*,/,= 
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Multiply Analytic Function: Returns the product of the arguments. 



Level 2 Level 1 -► Level 1 



z 2 

[[ matrix ]] 

[ array ] 

z 

[ array ] 

[ array ] 

z 

z 

'symb ' 

1 symb' 

z 

l symb 1 1 

'symb 2 ' 

#"i 

"2 

n i 

#n 2 

#/?! 

#n 2 

x^unit 

y_ unit 

X 

y-unit 

x_ unit 

y 

'symb' 

X-unit 

x_ unit 

'symb 1 






[[ matrix x array]] 
f z x array ] 

[ array x z ] 
l z * symb' 
l symb * z' 

, $ymb 1 * symb 2 1 

#"3 

#n 3 

#n 3 

xy_ unit x x unity 
xy_unit 
xy_unit 

1 symb * X-unit 1 
1 X-unit * symb 1 


Keyboard Access: (x) 

Affected by Flags: Numerical Results (—3), Binary Integer Wordsize 
(—5 through —10) 

Remarks: The product of a real number a and a complex number 

( x } y ) is the complex number ( xa, ya ). 

The product of two complex numbers (a?!, 2 ^) and (x 2 , ) is the 

complex number (x 1 x 2 ~ yiV 2 > x iV 2 + ^ 2 ^ 1 )* 

The product of a real array and a complex array or number is a 
complex array; Each element x of the real array is treated as a 
complex element (x, 0). 
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Multiplying a matrix (level 2) by an array (level 1) returns a matrix 
product. The matrix must have the same number of columns as the 
array in level 1 has rows (or elements, if it is a vector). 

Although a vector is entered and displayed as a row of numbers, the 
HP 48 treats a vector as an n x 1 matrix when multiplying matrices 
or computing matrix norms. 

Multiplying a binary integer by a real number returns a binary integer 
that is the product of the two arguments, truncated to the current 
wordsize. (The real number is converted to a binary integer before the 
multiplication.) 

The product of two binary integers is truncated to the current binary 
integer wordsize. 

When multiplying two unit objects, the scalar parts and the unit parts 
are multiplied separately. 

Related Commands: 
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Divide Analytic Function: Returns the quotient of the arguments: 
the level 2 object divided by the level 1 object. 



Level 2 


[ array ] 
[ array ] 


'symb 
x symb 1 

#n l 


#"i 

x_ unit 


x_ unit 
' symb 1 
x_ unit 


Level 1 


[[ matrix ]] 


'symb 


'symb 2 ' 


#U 2 

#^2 
y~ unit 2 

y_ unit 


x_ un/t 

'symb' 


Level 1 


z i / z : 


[[ matrix~ J x array ]] 
[ array/z ] 

1 z/symb' 
'symb/z' 

'symb x / symb 2 ' 

#^3 

7^r?3 

(x/y)^.unit 1 / unit 2 
(x/y) _ 1/unit 
(x/y)-unit 
'symb/x _ unit' 
'xunit/symb* 


{} 



Keyboard Access: 


SOLV 


' .. 1 ■ ■ p ' 1 ■ r 




- - - -- ■*««■»■■■■(■. i - r ■ r ■■■ ■ 

.....-I - ■ fe i | | | p|. , , .. 

'W'W.V 


V ViV.V.-.'.v 
■---v ^,v, 

'■■’*! ■ r ■i I i • ■ - ■ ■ 


0 


Affected by Flags: Numerical Results (-3) 

Remarks: A real number a divided by a complex number ( x. y) 


ax 

2 »j _nt 2 i 




ay 

x 2 -\-y’ 2 


returns ^ x - £* y2 , — r - ^ y2 ) * A complex number (x, y) divided by a real 
number a returns the complex number ( x/a , y/a). 

A complex number (x x , y x ) divided by another complex number (x 2 , 
y 2 ) returns this complex quotient: 
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/ 


f + yiy2 yi%2 yi y % \ 

V ^2 2 + 2/2 2 ’ ^2 2 + y2 2 ) 

An array B divided by a matrix A solves the system of equations 

AX=B for X; that is, X = A“’ 1 B. This operation uses 15-digit 
internal precision, providing a more precise result than the calculation 
INV<fl>*B. The matrix must be square, and must have the same 
number of columns as the array has rows (or elements, if the array is a 

vector). 

A binary integer divided by a real or binary number returns a binary 
integer that is the integral part of the quotient. (The real number is 
converted to a binary integer before the division.) A divisor of zero 
returns # 0. 

When dividing two unit objects, the scalar parts and the unit parts 
are divided separately. 

Related Commands: 


Power Analytic Function: Returns the value of the level 2 object 

raised to the power of the level 1 object. 



Level 2 

w 

z 

'symb' 
'symbi ' 

x_ unit 
x_ unit 


Level 1 


z 

'symb* 

z 

*symb 2 1 

y 

'symb' 


Level 1 


'z^(symb)' 

'( symb)~z ' 
'symb 1 ~(symb 2 )' 
x y _ unit y 

1 (x_ unit ) ''(symb ) 1 


Keyboard Access: fyH 
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< 


Affected by Flags: Principal Solution (—1), Numerical Results (—3) 

Remarks: If either argument is complex, the result is complex. 

The branch cuts and inverse relations for w z are determined by this 
relationship: 

w 2 = exp(^(ln w)) 

Related Commands: EXP, ISOL, LN, XROOT 


< 

Less Than Function: Tests whether one object is less than another 
object. 



Level 2 

■ —— 

X 

#Ul 

” string 1 " 
x 

1 symb' 

' symb 1 ' 
x_ unit 1 
x_ unit 
'symb' 


Level 1 


y 

#n 2 

" strin g 2 " 
'symb 1 
x 

' symb 2 1 

y__ unit 2 
'symb' 
x^unit 


Level 1 

o/i 

o/i 

0/1 

l x<symb l 
'symb<x' 

t symb 1 <symb 2 1 

0/1 

' X-unit<symb' 
l symb<x^unit' 


Keyboard Access: 




Affected by Flags: Numerical Results (—3) 

Remarks: The function < returns a true test result (1) if the level 2 
argument is less than the level 1 argument, or a false test result (8) 
otherwise. 
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If one object is a symbolic (an algebraic or a name), and the other is a 
number or symbolic or unit object, < returns a symbolic comparison 
expression that can be evaluated to return a test result. 

For real numbers and binary integers, "less than" means numerically 
smaller (1 is less than 2). For real numbers, “less than* 5 also means 
more negative (—2 is less than —1). 

For strings, “less than” means alphabetically previous (“ABC” is less 
than “DEF”; “AAA” is less than “AAB”; “A” is less than “AA”). In 
general, characters are ordered according to their character codes. 

This means, for example, that “B” is less than “a”, since “B” is 
character code 66, and “a” is character code 97. 

For unit objects, the two objects must be dimensionally consistent, 
and are converted to common units for comparison. If you use 
simple temperature units, the calculator assumes the values represent 
temperatures and not differences in temperatures. For compound 
temperature units, the calculator assumes temperature units represent 
temperature differences. For more information on using temperature 
units with arithmetic functions, refer to the entry for +. 

Related Commands: <,>,>, ==, ^ 


< 

Less Than or Equal Function: Tests whether one object is less than 

or equal to another object. 


3-404 Command Reference 
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Level 2 


Level 1 


Level 1 


{} 


#»i 

" string ± 


'symb' 
Y symb l 1 
x^unit 1 
x^unit 
1 symb 1 


#n 2 

" string 2 ' : 

'symb' 


'symb 2 
y_ unit 2 
'symb* 
x_ unit 


0/1 

0/1 

0/1 

'x < symb 1 
'symb < x' 
sym/> x < symb 2 1 
0/1 

*x_unit < symb 1 
*symb < x^unit' 


Keyboard Access: 




Affected by Flags: Numerical Results (—3) 


Remarks: The function < returns a true test result (1) if the level 2 

argument is less than or equal to the level 1 argument, or a false test 
result (8) otherwise. 


If one object is a symbolic (an algebraic or a name), and the other is a 
number or symbolic or unit object, < returns a symbolic comparison 
expression that can be evaluated to return a test result. 


For real numbers and binary integers, “less than or equal” means 
numerically equal or smaller (1 is less than 2). For real numbers, “less 
than or equal” also means equally or more negative (—2 is less than 

-i). 


For strings, “less than or equal” means alphabetically equal or 
previous (“ABC” is less than or equal to “DEF”; “AAA” is less than 
or equal to “AAB”; “A” is less than or equal to “AA”). In general, 
characters are ordered according to their character codes. This means, 
for example, that “B” is less than “a”, since “B” is character code 66, 
and “a” is character code 97. 


For unit objects, the two objects must be dimensionally consistent 
and are converted to common units for comparison. If you use 
simple temperature units, the calculator assumes the values represent 
temperature and not differences in temperature. For compound 
temperature units, the calculator assumes temperature units represent 
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< 


temperature differences. For more information on using temperature 
units with arithmetic functions, refer to the entry for 

Related Commands: <, >, >, ==, # 



Greater Than Function: Tests whether one object is greater than 

another object. 



Level 2 Level 1 — Level 1 


X 

#/?l 

" string ± ” 

x 

1 symb 1 
'sym^ 1 
x_ uni^ 
X-unit 
'symh' 


y 

#«2 

" string 2 ” 
'symb' 
x 

'symb 2 1 

y_ unit 2 
'symb' 
x_ unit 


0/1 

0/1 

0/1 

‘x>sym£>' 

1 symb>x * 

'sym^ >symb 2 1 
0/1 

1 x„unit>symb' 

' symbyx^unit' 


Keyboard Access: fpRG) 111 




MU 

■II 



Affected by Flags: Numerical Results (—3) 


Remarks: The function > returns a true test result (1) if the level 2 
argument is greater than the level 1 argument, or a false test result 
(0) otherwise. 

If one object is a symbolic (an algebraic or a name), and the other is a 
number or symbolic or unit object, > returns a symbolic comparison 
expression that can be evaluated to return a test result. 


For real numbers and binary integers, “greater than” means 
numerically greater (2 is greater than 1). For real numbers, “greater 
than” also means less negative (—1 is greater than —2). 
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For strings, “greater than” means alphabetically subsequent (“DEF” 
is greater than “ABC”; “AAB” is greater than “AAA”; “AA” is 
greater than “A”). In general, characters are ordered according to 
their character codes. This means, for example, that “a” is greater 
than “B”, since “B” is character code 66, and “a” is character code 97. 

For unit objects, the two objects must be dimensionally consistent 
and are converted to common units for comparison. If you use 
simple temperature units, the calculator assumes the values represent 
temperatures and not differences in temperature. For compound 
temperature units, the calculator assumes temperature units represent 
temperature differences. For more information on using temperature 
units with arithmetic functions, refer to the entry for +. 

Related Commands: <, <, >, ==, ^ 


> 

Greater Than or Equal Function: Tests whether one object is 

greater than or equal to another object. 



Level 2 Level 1 Level 1 


X 

Y 

#"l 

#n 2 

string t " 

" string 7 

X 

'symb' 

1 symb ' 

X 

1 symbi 1 

1 symb 7 

x_ unit^ 

y_ unit 7 

x_ unit 

' symb 1 

'symb 1 

x_ unit 





o/i 

0/1 

0/1 

s x > symb' 

1 symb > x s 
'symbi ^ sy tn 

0/1 

1 x_ unit > symb 1 
'symb > x„ unit 1 


Keyboard Access: ( prg ) HIS 



Affected by Flags: Numerical Results (—3) 
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Remarks: The function > returns a true test result (1) if the level 2 
argument is greater than or equal to the level 1 argument, or a false 
test result (0) otherwise. 

If one object is a symbolic (an algebraic or a name), and the other is a 
number or symbolic or unit object, > returns a symbolic comparison 
expression that can be evaluated to return a test result. 

For real numbers and binary integers, “greater than or equal to” 
means numerically equal or greater (2 is greater than or equal to 1). 
For real numbers, “greater than or equal to” also means equally or less 
negative (—1 is greater than or equal to —2). 

For strings, “greater than or equal to” means alphabetically equal or 
subsequent (“DEF” is greater than or equal to “ABC”; “AAB” is 
greater than or equal to “AAA”; “AA” is greater than or equal to 
“A”). In general, characters are ordered according to their character 
codes. This means, for example, that “a” is greater than or equal to 
“B”, since “B” is character code 66, and “a” is character code 97, 

For unit objects, the two objects must be dimensionally consistent 
and are converted to common units for comparison. If you use 
simple temperature units, the calculator assumes the values represent 
temperatures and not differences in temperature. For compound 
temperature units, the calculator assumes temperature units represent 
temperature differences. For more information on using temperature 
units with arithmetic functions, refer to the entry for +. 

Related Commands: <, <, >, ==, ^ 





Equals Analytic Function: Returns an equation formed from the two 

arguments. 
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Level 2 Level 1 


*1 Z 2 


z 

'symb' 

' symb ' 

z 

symb 1 ' 

‘ symb 2 

y 

x_ unit 

y„unit 

X 

y^unit 

x_ unit 

'symb' 

x_ unit 

x_unit 

'symb' 


Level 1 



z=symb' 
symb=z ? 


'symb 1 =symb 2 
'y=x^unit' 
y_unit=x' 
'y_unit=X- unit 
'symb=X-unit t 
! X-iinit=symb i 


Keyboard Access: 00 

Affected by Flags: Numerical Results (—3) 

Remarks: The equals sign equates two expressions such that the 
difference between the two expressions is zero. 

In Symbolic Results mode, the result is an algebraic equation. In 
Numerical Results mode, the result is the difference of the two 
arguments because = acts equivalent to — . This allows expressions 
and equations to be used interchangeably as arguments for symbolic 
and numerical root finders. 

The numerical evaluation of an equation using the HP Solve 
application implicitly involves the subtraction of terms. See the entry 
for ” for information about the effects of subtraction. 

Common usage is ambiguous about some units of temperature. When 
°C or °F represents a thermometer reading, then the temperature 
is a unit with an additive constant: 0 °C 273.15 K and 0 °F = 
459.67 0 R. But when °C or °F represents a difference in thermometer 
readings, then the temperature is a unit with no additive constant: 1 

°C = 1 K and 1 °F = 1 °R. 

The arithmetic operators +, —, %, %CH, and %T treat temperatures 
as differences, without any additive constant. However, , %CII, 
and %T require both arguments to be either absolute (K and °R), 
both °C, or both °F. No other combinations are allowed. 
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Related Commands: DEFINE EVAL, 



Logical Equality Function: Tests if two objects are equal. 



Level 2 Level 1 -* Level 1 


Objy 

obj 2 


0/1 

(*,0) 

X 


0/1 

X 

(x,0) 


0/1 

z 

'symb 1 

- 

' z—=symb 

% symb v 

z 


'symb—=z 

symb x 1 

* symb 2 i 


symb 1 ==symb : 


Keyboard Access: 


fPRGl Ilf 

“Pi P r - i p--pi ppp--ppr- 

.. 



Affected by Flags: Numerical Results (—3) 


Remarks: The function =$=: returns a true result (1) if the two 
objects are the same type and have the same value, or a false result 
(0) otherwise. Lists and programs are considered to have the same 
values if the objects they contain are identical. 


If one object is algebraic (or a name), and the other is a number 
(real or complex) or an algebraic, == returns a symbolic comparison 
expression that can be evaluated to return a test result. 

Note that == is used for comparisons, while = separates two sides of 
an equation. 

If the imaginary part of a complex number is 0, it is ignored when the 
complex number is compared to a real number, so, for example, 6 
< 61 0 > == returns 1. 

m- 


For unit objects, the two objects must be dimensionally consistent 
and are converted to common units for comparison. If you use 
simple temperature units, the calculator assumes the values represent 
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7 ^ 


temperatures and not differences in temperature. For compound 
temperature units, the calculator assumes temperature units represent 
temperature differences. For more information on using temperature 
units with arithmetic functions, refer to the entry for +. 

Related Commands: SAME, TYPE, <, <,>,>, ^ 


* 

Not Equal Function: Tests if two objects are not equal. 


Level 1 


o/i 

o/i 

0/1 

'z ^ symb' 
'symP ^ z‘ 
, symJb 1 ^ sym b 2 ' 


{} 


Level 2 


Level 1 


obj\ 

U,0) 


1 symb* 

sy/T7b 1 1 


°bj 2 


(x,0) 

'symb' 


1 symb 2 ' 


Keyboard Access: 




Affected by Flags: Numerical Results (—3) 


Remarks: The function ^ returns a true result (1) if the two objects 
have different values, or a false result (@) otherwise. (Lists and 
programs are considered to have the same values if the objects they 
contain are identical.) 


If one object is algebraic or a name, and the other is a number, a 
name, or algebraic, ^ returns a symbolic comparison expression that 
can be evaluated to return a test result. 


If the imaginary part of a complex number is 0, it is ignored when 
the complex number is compared to real number, so, for example, 6 
< 6 ? 0 ) # returns 0. 


Command Reference 3-411 














For unit objects, the two objects must be dimensionally consistent 
and are converted to common units for comparison. If you use 
simple temperature units, the calculator assumes the values represent 
temperatures and not differences in temperatures. For compound 
temperature units, the calculator assumes temperature units represent 
temperature differences. For more information on using temperature 
units with arithmetic functions, refer to the entry for +. 

Related Commands: SAME, TYPE, <, <, >, >, == 



Factorial (Gamma) Function: Returns the factorial n ! of a positive 

integer argument n, or the gamma function F(r+1) of a non-integer 
argument x. 



Level 1 


Level 1 


n 

x 

1 symb 1 


n\ 

r(x+i) 

1 ( symb \) 1 


Keyboard Access: [ mth) fNxf) llllll 


i m m 


i i ! • ! § I ! I 
I ! ! ! I ! I ! 




Affected by Flags: Numerical Results (—3), Underflow Exception 
(—20), Overflow Exception (—21) 


Remarks: For x > 253.1190554375 or n < 0, ! causes an Overflow 
exception (if flag —21 is set, the exception is treated as an error). For 
non-integer x < —254.1082426465, ! causes an Underflow exception (if 
flag —20 is set, the exception is treated as an error). 

In algebraic syntax, ! follows its argument. Thus the algebraic syntax 
for the factorial of 7 is 1 7 ! 1 . 

For non-integer arguments x, x\ = T(x + 1), defined for x > —1 as 
this: 
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/ 



and defined for other values of x by analytic continuation: 


r(# + 1) = n • F(x) 

Related Commands: COMB, PERM 



Integral Function: Integrates an integrand from lower limit to upper 
limit with respect to a specified variable of integration. 


{} 


Level 4 

Level 3 

Level 2 

Level 1 

-f Level 1 

lower limit 

upper limit 

integrand 

'name' 

- ‘symb^teg rai' 


Keyboard Access: Q0 

Affected by Flags: Numerical Results (—3), Number Format (—45 

to —50) 

Remarks: The algebraic syntax for / parallels its stack syntax: 
ft lower limit, upper limit , integrand, name ) 

where lower limit, upper limit , and integrand can be real or complex 
numbers, unit objects, names, or algebraic expressions. 

Evaluating J in Symbolic Results mode (flag —3 clear ) returns a 
symbolic result to level 1. The HP 48 does symbolic integration by 
pattern matching. The HP 48 can integrate the following: 

■ All built-in functions whose antiderivatives can be expressed 
in terms of other built-in functions—for example, SIN can be 
integrated since its antiderivative COS is a built-in function. The 
arguments for these functions must be linear. 
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Sums, differences, and negations of built-in functions whose 
antiderivatives can be expressed in terms of other built-in 
functions—for example, ' SIN < X) -COS<X > 1 . 

Derivatives of all built-in functions—for example, ‘ INV C l+X"-2> 1 
can be integrated because it is the derivative of the built-in function 

ATAN, 


Polynomials whose base term is linear—for example, 

:■ ! can be integrated since X is a linear term. 


l.l» 

n 

i 1 ' 1 . 

O i 

■w illW 

W 1 

i, i p .\ 

i ‘i tL. 


mm 

m - 

v 

A 

+ 

* 

w 

■ 

9 f 

n «■ 

A 

_ £ \ A 

o 

j 

■ 

t i 

# m 

1 

T ■ 

H 

m 

“ K J 

'“l 



A 

• 

1 1 




I 

V 

1 1 


f 


cannot be integrated since X**'’2~6 is 


not linear. 


Selected patterns composed of functions whose antiderivatives can 
be expressed in terms of other built-in functions—for example, 

1 1 / < COS < X ) *S IN < X) > 1 returns 1 LH < T AH < X > > '. 


If the result of the integration is an expression with no integral sign 
in the result, the symbolic integration was successful. If, however, the 
result still contains an integral sign, try rearranging the expression and 
evaluating again, or estimate the answer using numerical integration. 


A successful result of symbolic integration has this form: 

* result \ < name-upper limit)-(, result \ (.name-lower limit) > 1 


See the | (where) entry for more information about its functionality. A 
second evaluation substitutes the limits of integration into the variable 
of integration, completing the procedure. 

Evaluating j in Numerical Results mode (flag —3 set) returns a 
numerical approximation, and stores the error of integration in 
variable I ERR. J consults the number format setting to determine 

how accurately to compute the result. 

Examples: In Symbolic Results mode (flag —3 clear) this command 
sequence: 




' X ‘ 



returns 


I 


10*< 


B . J -'"l 






i j 


1 i 





1 


Subsequent evaluation substitutes the limits of integration, and 
returns 15. 
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In Numeric Results mode (flag —3 set) the above command 
sequence returns the numerical approximation 15. In addition, 
the variable IERR is created, and contains the error of integration 



Related Commands: TAYLR, d , S 


d 

Derivative Function: Takes the derivative of an expression, number, 
or unit object with respect to a specified variable of differentiation. 


{} 


Level 2 

Level 1 

- 

Level 1 


' s y m b i ' 

'name' 

■ ■ ' — 

l symb 2 1 


Z 

1 name ' 


0 


x_ unit 

'name' 


0 



Keyboard Access: 

Affected by Flags: Numerical Results (—3) 

Remarks: When executed in stack syntax, d executes a complete 
differentiation: the expression 1 symbi 1 is evaluated repeatedly until 
it contains no derivatives. As part of this process, if the variable of 
differentiation name has a value, the final form of the expression 
substitutes that value substituted for all occurrences of the variable. 

The algebraic syntax for d is 1 £name<.symbi > 1 . When executed 
in algebraic syntax, d executes a stepwise differentiation of symb 1 , 
invoking the chain rule of differentiation—the result of one evaluation 
of the expression is the derivative of the argument expression symb 1 , 
multiplied by a new subexpression representing the derivative of 
symb 1 ? s argument. 

If d is applied to a function for which the HP 48 does not provide a 
derivative, d returns a new T function whose name is der followed by the 
original function name. 
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Example: In Radians mode, the command sequence 1 £X < SIN < V > > 
EVflL returns 1 COS ( V > *dXV > 1 . 


When Y has the value X'''2:!, the command sequence 1 SIN<Y) ! ' X* 
returns ' C0S<X’"'2 > *<2*X> 1 . The differentiation has been executed 
in stack syntax, so that all of the steps of differentiation have been 
carried out in a single operation. 

Related Commands: TAYLR, /, E 


% 


Percent Function: Returns x (level 2) percent of y (level 1) 


Level 2 


Level 1 


Level 1 


{} 


'symb 1 

l symb l 


x_ unit 
' symb' 
x_ unit 


1 symb ' 


l symb 2 1 

y_ unit 


x_ unit 
1 symb ' 


xy/100 

'%(x,syn7£>)' 

l %(symb f x)' 
%{symb x , symb 7 ) x 
(xy/ 100) -unit 
(xy/100).„unit 
l %(symb t x _ unit ) 1 
'%(x_unit,symby 


Keyboard Access: ImthI lifiHi 


- +_+_! p+ r i ,ir>rrrrl » 


il p+tii-ll- i I i I I I' I ! 

Hp' It i '! ■ ■ i !■ t *• . I 

' 1 1 * 1 ' pH »■ H- I 

■ p r r r ■ *• • r »■ i I 


Kbfl h r t it 11 


p r p r“ p> r ' b h ttfPIH 


■ » HII I • ffl 1 1 I PPPPfPPffP**" 

}■ i- si- ii- ■ M ■ ■ 

imi i- *■ F Fj-ir * immimpp* 

Hi li HH m “PPPPPPPPPPPP**? 1 
« »■ s s I «■ U>.... 

-i-ti-Fi-PfeTfi piiiiipipipipp 

P t F t P t F t P P » P ■ * 4 P ■ P ■ P ■ ■ ■ P R 
■PPPPPPPPPPPPPPPPPPPPPMPPPP 


Affected by Flags: Numerical Results (—3) 

Remarks: Common usage is ambiguous about some units of 
temperature. When °C or °F represents a thermometer reading, then 
the temperature is a unit with an additive constant: 0 °C = 273.15 K, 
and 0 °F = 459.67 °R. But when °C or °F represents a difference in 

thermometer readings, then the temperature is a unit with no additive 
constant: 1 °C = 1 K and 1 °F = 1 °R. 
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The arithmetic operators %C11, and %T treat temperatures 

as differences, without any additive constant. However. +, %CH, 
and %T require both arguments to be either absolute (K and °R), 
both °C, or both °F. No other combinations are allowed. 

For more information on using temperature units with arithmetic 
functions, see the entry for +. 


Example: 


j 

W f9 




returns 



15 176 k 9 returns 26-4_kg. 


100_"C 50 X returns 50_ a C. 

Related Commands: %CH. %T 


7T 

it Function: Returns the symbolic constant ' it 1 or its numerical 
representation, 3.14159265359. 


Level 1 -+ Level t 


i i 

7T 

3.14159265359 


Keyboard Access: (*£)(¥) 

Affected by Flags: Symbolic Constants (—2), Numerical Results 

(- 3 ) 

Evaluating it returns its numerical representation if flag —2 or —3 is 
set; otherwise, returns its symbolic representation. 

Remarks: The number returned for n is the closest approximation of 
the constant 7 r to 12-digit accuracy. 

In Radians mode with flags —2 and —3 clear (to return symbolic 
results), trigonometric functions of tt and tt/ 2 are automatically 
simplified. For example, evaluating 1 SIN ( rr> 1 returns zero. 

However, if flag —2 or flag —3 is set (to return numerical results), 
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7r 


then evaluating 1 SIN ( it !> 
-2.06761537357E-13. 


returns the numerical approximation 


Related Commands: e, i, MAXR, MINR, -^Qir 


1 

Summation Function: Calculates the value of a finite series. 



Level 4 Level 3 Level 2 Level 1 — Level 1 


t indx i 

X- .* 
in it 

t indx t 

1 in it' 

'indx' 

X init 

1 indx 1 

1 init 


x fi n a 1 

smnd 

x fi n a 1 

smnd 

' final 1 

smnd 

' final' 

smnd 


x sum 

"E(indx=init r x final ,smnd)' 
’E(>/7c/x=:X| n j t t final,smnd)' 
"L(indx=:init, final,smnd ) 1 


Keyboard Access: (7»)fxn 

Affected by Flags: Symbolic Constants (—2), Numerical Results 

(- 3 ) 

Remarks: The summand argument smnd can be a real number, a 
complex number, a unit object, a local or global name, or an algebraic 
object. 

The algebraic syntax for S differs from the stack syntax. The 
algebraic syntax is this: 

1 2 (. indez?= initial,final,summand) 1 


Examples: In Symbolic Results mode (flags —2 and —3 
clear), the command sequence 1 N ' 15 1 R'"’N 1 2 returns 


' R+R 




+R * s 4+R *'** 5 



The command sequence 


<N=lsl>tsfl A N> 




Related Commands: TAYLR, /, d 


returns 
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Sigma Plus Command: Adds one or more data points to the current 
statistics matrix (reserved variable EDAT). 


Level m 


» i * 


Level 2 


Level 1 


Level 1 


[ *2 ••• ] 

[[ Xi i ... X^ m ] [ X n i ... X n m ]] 


... i 




Keyboard Access: f+jlI stat l 


- . fc .■*'#] E "f-- 


f I — 



Affected by Flags: None 


Remarks: For a statistics matrix with m columns, arguments for £+ 
can be entered several ways: 


■ To enter one data point with a single coordinate value, the 
argument for E+ must be a real number. 

■ To enter one data point with multiple coordinate values, the 
argument for £+ must be a vector of m real coordinate values. 

■ To enter several data points, the argument for £+ must be a matrix 
of n rows of m real coordinate values. 


In each case, the coordinate values of the data point(s) are added as 
new rows to the current statistics matrix (reserved variable EDAT). 

If EDAT does not exist, £+ creates an n x m matrix and stores the 
matrix in EDAT . If EDAT does exist, an error occurs if it does not 
contain a real matrix, or if the number of coordinate values in each 
data point entered with £+ does not match the number of columns in 
the current statistics matrix. 


Once EDAT exists, individual data points of m coordinates can be 
entered as m separate real numbers or an m-element vector. 

LASTARG returns the m-element vector in either case. 

Example: The sequence CL I C 2 3 4 3 2+ 3 1 7 2+ creates the 
matrix [[ 2 3 4 3C 3 1 7 3] in EDAT. 
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Related Commands: CLE, RCLE, STOE, E 



Sigma Minus Command: Returns a vector of m real numbers (or 
one number x if m — 1) corresponding to the coordinate values of 
the last data point entered by E+ into the current statistics matrix 
(reserved variable EDAT). 



Keyboard Access: S)(stat) 




Affected by Flags: None 


Remarks: The last row of the statistics matrix is deleted. 


The vector returned by E— can be edited or replaced, then restored to 
the statistics matrix by E+. 

Related Commands: CLE, RCLE, STOE, E+ 


w 

Square Root Analytic Function: Returns the (positive) square root 

of the argument. 
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Level 1 -+ Level 1 

! Z 

x-unit 
' symb* 

Keyboard Access: f7T) 

Affected by Flags: Principal Solution (—1), Numerical Results (—3) 

Remarks: For a complex number (a?!, y 1 ), the square root is this 
complex number: 

(^2=t/2) = {y/rcos 9 -, yjrsin®-) 

where r — ABS [x x , y x ), and 9 — ARG {x x , y x ), 

If ( x i j Vi) = (0, 0), then the square root is (0, 0). 

The inverse of SQ is a relation , not a function, since SQ sends more 
than one argument to the same result. The inverse relation for SQ is 
expressed by ISOL as this general solution : 

1 ! 

The function yj is the inverse of a pari of SQ, a part defined by 
restricting the domain of SQ such that 1) each argument is sent to a 
distinct result, and 2) each possible result is achieved. The points 
in this restricted domain of SQ are called the principal values of the 
inverse relation. The yj function in its entirety is called the principal 
branch of the inverse relation, and the points sent by \J to the 
boundary of the restricted domain of SQ form the branch cuts of yj. 

The principal branch used by the HP 48 for yj was chosen because 
it is analytic in the regions where the arguments of the real-valued 
inverse function are defined. The branch cut for the complex-valued 
square root function occurs where the corresponding real-valued 
function is undefined. The principal branch also preserves most of the 
important symmetries. 

The graphs below show the domain and range of yj. The graph of the 
domain shows where the branch cut occurs: the heavy solid line marks 
one side of the cut, while the feathered lines mark the other side of 
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the cut. The graph of the range shows where each side of the cut is 
mapped under the function. 

These graphs show the inverse relation ' sl*TZ 1 for the case si — 1. 
For the other value of si. the half-plane in the lower graph is rotated. 
Taken together, the half-planes cover the whole complex plane, which 
is the domain of SQ. 

View these graphs with domain and range reversed to see how the 
domain of SQ is restricted to make an inverse function possible. 
Consider the half-plane in the lower graph as the restricted domain 
Z = < x n y >. SQ sends this domain onto the whole complex plane in 
the range W = C u ? v > = SQ < x ? y > in the upper graph. 

Related Commands: SQ, \ ISOL 


! Domain: Z = (x,y) 

»»r 

{ 0 

X 

\ 

\ 

\ 

N 

T777TTTT7T77TJ 

i 

\ 

\ 

x 

X 

^ X _ 

- 1 1 

l 

t 

f 

t 

/ 

/ 

** 

Range: W = (u,v) =7(x,y) 



X 

X 

X 

\ 

0 

V 


^ * 

^ * 

^ * 

^ f 

. / 

^ s 
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Attach Unit Function: Attaches a unit expression to a real number. 
Performed automatically in the Unit Catalog ([rHfUNITS);. 


Level 2 

Level 1 

■* Level 1 

X 

' unit expression' 

■+ x-unit 


Keyboard Access: @Q 
Affected by Flags: None 
Related Commands: —►UNIT 


| (Where) 

Where Function: Substitutes values for names in an expression. 


Level 2 Level 1 -► Level 1 

'sym6 okl { name 1 symb 1 ' name 2 symb 2 ... } —► % symb new 

x { name 1 ' symb 1 1 name 2 1 symb 2 1 ... } —► x 

(x, y) { name 1 'sym/^ 1 name 2 symb 2 1 ...}-» (x, y) 


Keyboard Access: r»i1ifsYMBOLic1 fNXT 




Affected by Flags: Numerical Results (“3) 


Remarks: 


is used primarily in algebraic objects, where its syntax is: 


52/m6 0 id i '-.namei-symbi * name2~$ymb2 


ti* 


It enables algebraics to include variable-like substitution information 
about names. Symbolic functions that delay name evaluation (such 
as J and d) can then extract substitution information from local 
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| (Where) 

variables and include that information in the expression, avoiding the 
problem that would occur if the local variables no longer existed when 
the local names were finally evaluated. 

Related Commands: APPLY, QUOTE 


Create Local Variables Command: Creates local variables. 


Level n 


Level 1 


Level 1 


obj 1 ... obj n 


Keyboard Access: 

Affected by Flags: None 

Remarks: Local variable structures specify one or more local 
variables and a defining procedure. 


A local variable structure consists of the 


command, followed by one 


or more names, followed by a defining procedure^-either a program or 


an algebraic. The 


command stores objects from the stack into local 


variables with the specified names. The resultant local variables exist 
only while the defining procedure is being executed. The syntax of a 
local variable structure is one of the following: 

■ * namei name^ • *. name n ■<=' program & 

■ * namci name 2 *.. name n 1 algebraic expression 1 

Example: This program: 


x y « x y * x 


j h 

"I" ,v ,v 


takes an object from level 2 and stores it in local variable x, takes 
an object from level 1 and stores it in local variable y y and executes 
calculations with x and y in the defining procedure (in this case a 
program). When the defining procedure ends, local variables x and y 
disappear. 
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User-Defined Functions. A user-defined function is a variable 

containing a program that consists solely of a local variable structure. 
For example, the variable A , containing this program: 


* r 







is a user-defined function. Like a built-in function, a user-defined 
function can take its arguments in stack syntax or algebraic syntax, 
and can take symbolic arguments. In addition, a user-defined function 
is differentiable if its defining procedure is an algebraic expression that 
contains only differentiable functions. 

Related Commands: DEFINE, STO 
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Equation Reference 


The Equation Library consists of 15 subjects and more than 100 
titles. Each subject and title has a number that you can use with 
SOLVEQN to specify the set of equations. These numbers are shown 
in parentheses after the headings. 

See the end of this section for references given in each subject 
(Reference: x ). Remember that some equations are estimates and 
assume certain conditions. See the references or other standard texts 
for assumptions and limitations of the equations. 

Solutions in the examples have been rounded to four decimal places. 


Columns and Beams (1) 


Variable Names and Descriptions 


e 

Eccentricity (offset) of load 

acr 

Critical stress 

crmax 

Maximum stress 

9 

Slope at x 

A 

Cross-sectional area 

a 

Distance to point load 

c 

Distance to edge fiber (Eccentric Columns), or 

Distance to applied moment (beams) 

E 

Modulus of elasticity 

I 

Moment of inertia 
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Variable Names and Descriptions (continued) 


K 

Effective length factor of column 

\ L 

Length of column or beam 

M 

Applied moment 

Mx 

Internal bending moment at x 

P 

Load (Eccentric Columns), or 

Point load (beams) 

Per 

Critical load 

r 

Radius of gyration 

V 

Shear force at x 

W 

Distributed load 1 

X 

Distance along beam 

y i 

Deflection at x 


For simply supported beams and cantilever beams (“Simple 
Deflection’ 7 through “Cantilever Shear 77 ), the calculations differ 
depending upon the location of x relative to the loads, 

■ Applied loads are positive downward. 

■ The applied moment is positive counterclockwise. 

■ Deflection is positive upward. 

■ Slope is positive counterclockwise. 

■ Internal bending moment is positive counterclockwise on the 
left-hand part. 

■ Shear force is positive downward on the left-hand part. 
Reference: 2. 


4-2 
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Elastic Buckling (1, 1) 

These equations apply to a slender column ( K-L/r > 100) with length 
factor K. 



K=.S K=.l k=i K=a 



Equations: 





Example: 

Given: 7=7.3152_m, r=4.1148_cm, £=199947961.502 JtPa, 
>1=53.0967 cm*2, if=0.7, /=8990598.7930_mm''4. 

Solution: Pcr=676.6019_kN, <rer=127428.2444_kPa. 


Eccentric Columns (1, 2) 

See “Elastic Buckling.” 
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Equations: 




\ \ 


crmax = 


P 

A 






Example: 

Given: Z=6.6542_m, A=187.9351_cm'2, r=8.4836_cm, 
£=206842718.795_kPa, /=135259652.16_mm''4, K= 1, 
P= 1908.2571 _kN, c=15.24_cm, €=1.1806_cm. 

Solution: amax— 140853.0970_kPa. 


Simple Deflection (1, 3) 



Equation: 




W-X 

24EI 
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Example: 

Given: i=20_ft, i?=29OOQG0O_psi, J=40_in~4, a“10_£t, 
P=674.427_lbfj c=17_ft, w;=102.783_lbf/ft, 

£—£Lft. 

Solution: y~~ .6005_in. 

Simple Slope (1, 4) 



Equation: 



w 

24-E-I 





Example: 

Given: Z-=20_ft, £'=29000000_psi, 1= 40_in*4, a=10_ft, 
P=674.427_lbf, c=17_ft, Af=3687.81_ft*lbf, w=102.783_lbf/ft, 
x=9_ft. 

Solution: ,0876_°. 
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Simple Moment (1, 5) 



i 


:0LV 

E I-! N 

h F :$ 

PIC 

rt-PICT 

EMIT ! 


Equation: 



Example: 

Given: L=20 ft, a=10_ft, P=674.427_lbf, t-17 ft, 
Af=3687.81_ft*lbf, w=102.783JM/ft, z=9_ft. 

Solution: Mc=9782.1945_ft*lbf. 

Simple Shear (1, 6) 



Equation: 
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Example: 

Given: £=20_ft, a=10_ft, P=674.427_lbf, M=3687.81 JWbf, 
w>=102.783_lbf/ft, x=9^ft. 

Solution: P=624.387_lbf. 

Cantilever Deflection (1, 7) 




E£:N 

V h F; S 

• 

PIC 

■+P 

ICT 


EMIT 


Equation: 

_ P-x 2 
y “ 6EI 



+ 


M*x 


wx 


2*E*I 24EI 



— 4-L-x + x 2 



Example: 

Given: £=KLft, £=2900000(Lpsi 3 /=15Jn~4, P=500Jbf, 
M =800_.ft*lbf, a=3_ft, c=6_ft, ttf=100^1bf/ft, £=8_ft. 

Solution: y~— .3316_in. 


Cantilever Slope (1, 8) 



Equation Reference 4-7 



Equation: 





Mx 

EM 


w-x 

6-E-I 


3L 2 — 3-Lx + 


Example: 

Given: 1=10 ft, £=29000000_psi, /= 15_m“4, P=500_lbf, 
M =800_ft*lbf, a=3_ft, c=6_ft, w=100_lbf/ft, £=8_ft. 

Solution: &=— .2652_°. 

Cantilever Moment (1, 9} 



Ei'lN 

h F; l“ 

PIC 

■+PICT 

EMIT 


Equation: 


Mx = P- 





2-L-x + x" 



Example: 

Given: 1=10. ft, P=500_lbf, M=800_ft*lbf, a=3_ft, c=6_ft, 
i«=100_lbf/ft, x=8_ft. 

Solution: 200_ft*lbf. 
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Cantilever Shear (1,10) 



Equation: 


V = P + w- 



Example: 

Given: i=10. ft. P=500_lbf, a=3_ft, r=8_ft, w=100_lbf/ft. 
Solution: V=200_lbf. 


Electricity (2) 


Variable Names and Descriptions 


er 

Relative permittivity 

jl V 

Relative permeability 

D 

Angular frequency 

ujO 

Resonant angular frequency 

4> 

Phase angle 

<t>pAs 

Parallel and series phase angles 

P 

Resistivity 
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Variable Names and Descriptions (continued) 

j— — 

AI Current change 

At j Time change 

A V Voltage change 

A Wire cross-section area (Wire Resistance), or 

Solenoid cross-section area (Solenoid Inductance) 
Plate area (Plate Capacitor) 

0,01,02 Capacitance 

Cp,Cs Parallel and series capacitances 

d Plate separation 

E Energy 

F Force between charges 

/ i Frequency 

fO Resonant frequency 

I Current, or 

Total current (Current Divider) 

II Current in R1 

I max Maximum current 

L Inductance, or 

Length (Wire Resistance, Cylindrical Capacitor) 
LI ,L2 Inductance 

Lp,Ls ; Parallel and series inductances 

N Number of turns 

n Number of turns per unit length 

P Power 

q Charge 

ql , q2 Point charge 

Qp,Qs Parallel and series quality factors 
r Charge distance 

R , R1, R 2 Resistance 

ri,ro Inside and outside radii 

Rp,Rs Parallel and series resistances 
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Variable Names and Descriptions (continued) 


t 

Time 

ti,tf 

Initial and final times 

V 

Voltage, or 

Total voltage (Voltage Divider) 

4 i 

VI 

Voltage across R1 

Vi, Vf 

Initial and final voltages 

Vraax 

Maximum voltage 

xc 

Reactance of capacitor 

XL 

1 Reactance of inductor 


Reference: 3* 


Coulomb’s Law (2,1) 

This equation describes the electrostatic force between two charged 
particles. 


Equation: 



Example: 

Given: ql= 1.6E-19-C, ?2=1.6E-19_C, r=4.00E-13_cm, er=1.00. 
Solution: E=14.3801_N. 

Ohm’s Law and Power (2, 2) 

Equations: 

V 2 

V = IR P = VI P = I 2 R P = — 

R 
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Example: 

Given: 7=24_V, 7=16_A. 
Solution: J=1J_I7 > P=384_.W. 

Voltage Divider (2, 3) 



Equation: 

Vi = vf- R1 -1 

{ El + R2 J 

Example: 

Given: Rl= 40_fi, E2=10_Q, K=100_V. 
Solution: VI = 80_V. 

Current Divider (2, 4) 



4-12 Equation Reference 



Equation: 


II = I- 



Example: 

Given: Rl = R2=6J1, 1= 15_A. 

Solution: 11 = 5.6250_A. 


Wire Resistance (2, 5) 

Equation: 


Example: 


Given: p 


.0035_Q*cm, Z=50_cm, A=l-cm'2. 


Solution: ii=0.175_Q. 

Series and Parallel R (2, 6) 



Equations: 


Rs = R1 + R2 




Equation Reference 4-13 



Example: 

Given: Rl = 2_Q, R2—i-Q,. 
Solution: /£s=5_S2, lip—1.20Q0_f2. 

Series and Parallel C (2, 7) 



Equations: 



Cp = Cl + C2 


Example: 

Given: C1=2-/j,F, C2=3-/jiF. 
Solution: Cs=1.2000_/iF, Cp=5_/uF. 


Series and Parallel L (2, 8) 


Ll 
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Equations: 


l 


Ls = LI + L2 


1 


Lp LI 



Example: 

Given: i,i=17_mn, L#=16.5_mH. 

Solution: Ls=33.5000_mH, Lp=8.3731_mH. 

Capacitive Energy (2, 9) 

Equation: 


Example: 

Given: £=.025_J, C=20 _a*F. 
Solution: L=50_V. 

Inductive Energy (2, 10) 

Equation: 


Example: 

Given: E= 4_J, L=15_mH. 
Solution: 7=23.0940_A. 
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RLC Current Delay (2,11) 

The phase delay (angle) is positive for current lagging voltage. 




EC:N 

va m 

PIC 

■+PICT 


EMIT 


Equations: 


1 


1 


TAN 



XL-XC 

R 


TAN 



XC XL 
1 

R 


XC 


1 


UJ -C 


XL = w-L 


u = 2-w-f 


Example: 

Given: /=107_Hz, C=80_/iF, L=20_mH, R= 5_ft. 

Solution: w=672.3008_r/s, <j>s=— 45.8292-°, <j>p=— 5.8772 _°, 
XC=18.5929_ft, JX=13.4460_CL 

DC Capacitor Current (2, 12) 

These equations approximate the dc current required to change the 
voltage on a capacitor in a certain time interval. 

Equations: 

I = C • [=Jj AV =“Vf — Vi At = tf-ti 
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Example: 

Given: C=15_^F, Vi= 2.3_V, V7=3.2_V, 1= 10_A, ti= 0_s. 
Solution: AV=.9000_V, At=1.3500_/is, </=1.3500_^s. 

Capacitor Charge (2,13) 

Equation: 

q = CV 


Example: 

Given: C=20_/iF, F=100_V. 

Solution: g=0.0020_C. 

DC Inductor Voltage (2,14) 

These equations approximate the dc voltage induced in an inductor by 
a change in current in a certain time interval. 

Equations: 

v = — L ( AI = If — Ii At = tf — ti 


Example: 

Given: £=100_mH, K=52_V, At= 32__>us, Ii— 23_A, ti= 0_s. 
Solution: AI-— 0.0166-A, If— 22.9834_A, tf= 32_//s. 
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RC Transient (2,15) 



Equation: 

-t 

V = Vf- f Vf - Vi) e RC 

Example: 

Given: Vi=0_V, C*=50_AiF, V/=10_V, ^= 100 - 0 ;, t 
Solution: V=3.2968_V. 

RL Transient (2, 16) 






IUI 

EClN 


PIC 



Equation: 



2_ms. 


4-18 Equation Reference 



Example: 

Given: W=0_V, V7=5_V, R=50_w, I=50_mH, 2=75_ps. 
Solution: /=0.0072_A. 

Resonant Frequency (2,17) 

Equations: 

l 

cjO = __ - 

Vl-c 

Example: 

Given: I=500_mH, C=8^F, R= 10_w, 

Solution: w0=5OO_r/s, Qs=25.0000, Qp=0.0400, /0=79.5775_Hz. 

Plate Capacitor (2,18) 


Qs 


1 

R 



Qp 



O>0 “ 2 * 7T *f0 



Equation: 



e() * ev * A 

d 


Example: 

Given: C~ 25_/iF, er=2.26, A=l_crrT2 
Solution: d=8.0Q42E—9_cm. 
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Cylindrical Capacitor (2, 19) 



£ D LEQN VHFPhi 



e:;it 


Equation: 

2-^-eO-er-L 

' = “TIT 

Example: 

Given: er=l. ro=l_cm ? n = .999_cm, £=10_cm. 
Solution: C— 0 . 0056 F. 


Solenoid Inductance (2, 20) 


H-h-H 



Du 

PH 

pj 

PH 




PH 


Ql 











lur 


"d 

hd 

nd 

nd 

hd 

run 


hd 

T 


L 


sam ec:n o rs pic *pict exit 


Equation: 


L = -n 2 • A*h 


Example: 

Given: fir= 2.5. n=:40_l/cm 3 A—.2_cm^2 ? /i=3_cm. 
Solution: L=0.0302_mll. 


4-20 Equation Reference 



Toroid Inductance (2, 21) 



0 L 

E«”:N ! 

V li Fi S 

PIC 

*PICT 

EMIT 


Equation: 



Example: 

Given: n r ~ 1, AT=5000, h=: 2_cm, h=2_cm, ro— 4_cm. 
Solution: Z=69.3147_mH. 

Sinusoidal Voltage (2, 22) 

Equations: 

V = Vmax-SIN f w-t 4- <j> | u — 2-w-i 


Example: 

Given: Vma;r=110_V, t— 30_//s, f— 60_Hz, <^=15_°. 
Solution: «— 376.9911 _r/s, K=29.6699_V. 

Sinusoidal Current (2, 23) 

Equations: 

I = Imax SIN [w-t + ^1 u> = 2 -tt- f 
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Example: 

Given: 32_s, fmax— 10_A, u;—636_r/s, </>=30_°. 

Solution: 7=9.5983_A ? /=101.2225_Hz. 


Fluids (3) 


Variable Names and Descriptions 

€ 

Roughness 

P 

Dynamic viscosity 

P 

Density 

AP 

Pressure change 

Ay 

Height change 

UK 

Total fitting coefficients 

A 

(Toss-sectional area 

A1,A2 

i Initial and final cross-sectional areas 

D 

Diameter 

DJ,D2 

Initial and final diameters 

h 

Depth relative to PO reference depth 

hL 

Head loss 

L 

Length 

M 

Mass flow rate 

n 

Kinematic viscosity 

P 

Pressure at h 

PO 

Reference pressure 

PI ,P 2 1 

Initial and final pressures 

Q 

Volume flow rate 

Re 

Reynolds number 

vl ,v2 

Initial and final velocities 

vavg 

Average velocity 


Power input 

yi,y2 

Initial and final heights 


I ■ I II ' » —- ■ ■■- 


References; 3, 6, 9. 
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Pressure at Depth (3,1) 

This equation describes hydrostatic pressure for an incompressible 
fluid. Depth h is positive downward from the reference. 




EQH YAR 





Equation: 


P = PO + p' g-h 


Example: 

Given: &=100_m, ^=1025.1817 Jtg/irf 3, PO— Latm. 

Solution: P=l 106,6848-kPa. 

Bernoulli Equation (3, 2) 

These equations represent the streamlined flow of an incompressible 
fluid. 
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Equations: 




T g-Ay — 0 



4- g-Ay = 0 


+ g-Ay = 0 


AP = P2 — PI Ay = v2 — yl M = p • Q 


Q = A2 • v2 



Q = A1 • vl 



7T-D2 2 



Example: 

Given: Pl?=25_psi, PI =75_psi, yi?=35_ft, yl — 0_ft, Z>i=18_in, 
p=64_lb/ft'3, vi = 100_ft/s. 

Solution: Q=10602.8752_ft''3/min, M=678584.0132_lb/min, 
tt?=122.4213_ft/s, A#=207.8633_in"2, Zh?=16.2684_in, 

A1 =254.4690_in"2, AP=-50_psi, Aj=35_ft. 


Flow with Losses (3, 3) 

These equations extend Bernoulli’s equation to include power input 
(or output) and head loss. 
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Equations: 




+ 


v2 2 — vl 2 
2 


+ g-Ay+ hL 






4- g-Ay + hL 





AP 

P 


vl 


+ 


A1 

A2 


1 


2 


+ g-Ay+ hL 



AP = P2 - PI 


Ay = y2-yl M = p-Q 


Q = A2-v2 


Q = Al-vl 




7T • D2 2 

4 


Example: 

Given: P2=30_psi, Pl=65_psi, ^=100_ft, yJf=0_ft, p=64_lb/ft'3, 
Dl= 24_in, AX=2.0_ft"2/s"2, W= 25_hp, vl= 100_ft/s. 

Solution: Q=18849.5559_ft“3/min, M =1206371.5790_.lb/min. 

AP=- 35_psi, Aj=100_ft, i>f=93.1269_ft/s, J 4/=452.3893_iiT2, 
Ag=485.7773_in'2. 2)2=24.8699_in. 
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Flow in Full Pipes (3, 4) 

These equations adapt Bernoulli’s equation for flow in a round, full 
pipe, including power input (or output) and frictional losses. (See 

“FANNING” in chapter 3.) 



AP — P2 — PI Ay = y2 —yl M = p-Q 


7T-D 2 D-vavg-p 

Q = A-vavg A = —-— Re =- n = 

4 p 


Example: 

Given: /?=62.4_lb/ft"3, D= 12_in, vavg= 8_ft/s, PS=15_psi, 

Pl= 20_psi, y2= 40_ft, yjf=0_ft, p=.00002Jbf*s/fr2, SK- 2.25, 
e=.02_in, i=250_ft. 

Solution: AP=— 5_psi, Aj/=40_ft, A=113.0973_nT2, 
n=1.0312_ft~2/s, g=376.9911_ft~3/mm, M=23524.2458_lb/min, 
PF=25.8897_hp, £e=775780.5. 
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Forces and Energy (4) 


Variable Names and Descriptions 


a 

Angular acceleration 

U) 

Angular velocity 

ui,vf 

Initial and final angular velocities 

P 

Fluid density 

T 

Torque 

© 

Angular displacement 

a 

Acceleration 

A 

Projected area relative to flow 

ar 

Centripetal acceleration at r 

at 

Tangential acceleration at r 

Cd 

Drag coefficient 

E 

Energy 

F 

Force at r or x, or 

Spring force (Hooke’s Law), or 

Attractive force (Law of Gravitation), or 

Drag force (Drag Force) 

I 

Moment of inertia 

k 

Spring constant 

Ki , Kf 

Initial and final kinetic energies 


Mass 

N 

Rotational speed 

Ni, Nf 

Initial and final rotational speeds 

P 

Instantaneous power 

Pavg 

Average power 
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Variable Names and Descriptions (continued) 


r 

Radius from rotation axis, or 


Separation distance (Law of Gravitation) 

t 

Time 

V 

Velocity 

vf,vlf,vSf 

Final velocity 

vi , vl i 

Initial velocity 

w 

Work 

X 

Displacement 


Reference: 3. 


Linear Mechanics (4,1) 


Equations: 


F = m-a Ki: 

1 

= - m vi 

Kf = 

- * m • vf 2 W — F ■ x 


2 


2 




W ■ 

W = Kf - Ki 

P = F v 

Pavg 

—- — vf = vi + a-t 

t 


Example: 

Given: <—1 0_s, m=50_lb, a=12.5_ft/s"2, 

Solution: vf— 125_ft/s, a:=625_ft, J 5 '=19.4256_lbf, Ki— 0_ft*lbf, 
A7=12140.9961_ft*lbf, VF=12140.9961 ft*lbf, P«ijr=2.2075_hp. 
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Angular Mechanics (4, 2) 


Equations: 



W = Kf — Ki P = t-u 


at = ar w = 2-7r-N 


1 


Kf = -Iwf 2 
2 

W 

II 

CD 

W 

Pavg = — 

u f = 

(jj\ + a-t 

wi — 2*7r*Ni 

uf — 

2-TT-Nf 


Example: 

Given: 7=1750_lb*irr2, <9=360_°, r=3.5_in, a=10.5_r/min~2, 

uii= 0_r/s. 

Solution: r=1.1017E-3_ft*lbf, /u=0_ft*lbf, If=6.9221E-3_ft*lbf, 
,fif/=6.9221E—3_ft*lbf, af=8.5069E-4_ft/s~2, iVi=0_rpm, 
w/=11.4868j/min, t=1.0940_min, Nf= 1.8282_rpm, 
-Pat;g=1.9174E—7_hp. 


Centripetal Force (4, 3) 

Equations: 

-n 9 V 

F = m-uj *r uj — - 

r 

Example: 

Given: m— l_kg, r=5_cm, N~ 2000_Hz. 

Solution: u)~ 12566.3706_r/s, ar=7895683.5209-m/s, 
F=7895683,5209_N, tf=62.8.3185_m/s. 


ar 


U) — 2-7T-N 
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Hooke’s Law (4, 4) 

The force is that exerted by the spring. 



SDLM E* 




PIC h»-PICT EMIT 


Equations: 




Example: 

Given: £=1725 lbf/iri. x =1.25 in. 

Solution: F=-2156.25_lbf, W=~l 12.3047_ft*lbf. 

ID Elastic Collisions (4, 5) 



E 



Equations: 



ml — m2 
m 1 + m2 




2* ml 
ml + m2 


•vli 
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Example: 

Given: m / = 10_kg, 25 kg, vli— 100__m/s, 

Solution: vlf—— 42.8571_m/s, i?^/=57.1429_m/s. 

Drag Force (4, 6) 

Equation: 



Example: 

Given: Cd=. 05, /9=1000_kg/m~3, ^4=7.5E6_cm'2, i!=35_m/s. 
Solution: F=22968750_N. 

Law of Gravitation (4, 7) 

Equation: 

F= G.(^) 

Example: 

Given: mi—2E15-kg, ml?=2E18„kg, r=100000CLkm. 

Solution: F— 266903.6_N. 

Mass-Energy Relation (4, 8) 

Equation: 

E = me 2 
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Example: 

Given: m=9.1E—31_kg. 
Solution: £=8.1787E-14_J. 


Gases (5) 


Variable Names and Descriptions 


A 

Mean free path 

P 

Flow density 

pO 

Stagnation density 

A 

Flow area 1 

At 

Throat area 

d 

Molecular diameter 

k 

Specific heat ratio 

M 

Mach number 

m 

Mass 

MW 

Molecular weight 

n 

Number of moles, or 


Polytropic constant (Polytropic Processes) 

p 

Pressure, or 


Flow pressure (Isentropic Flow) 

PO 

Stagnation pressure 

, Pc 

Pseudocritical pressure 

Pi,Pf 

Initial and final pressures 

T 

i Temperature, or 


Flow temperature (Isentropic Flow) 
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Variable Names and Descriptions (continued) 


TO 

Stagnation temperature 

Tc 

Pseudocritical temperature 

Ti, Tf 

Initial and final temperatures 

V 

Volume 

Vi, Vf 

Initial and final volumes 

vrms 

Root-mean-square (rms) velocity 

w 

Work 


References: 1, 3. 

Ideal Gas Law (5,1) 

Equations: 

PV = n-R-T m = n-MW 

Example: 

Given: r=16.85_°C, P=l_atm, R=25_l, MW =36_g/gmol. 
Solution: n=1.0506_gmol, m=3.7820E—2_kg. 

Ideal Gas State Change (5, 2} 

Equation: 

Pf-Vf _ Pi-Vi 
Tf ~ Ti 

Example: 

Given: Pt=1.5_kPa, P/=1.5_kPa, Vi= 2_I, P2=:100- o C > 

Tf= 373.15-K. 

Solution: Vf— 2_1, 
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Isothermal Expansion (5, 3) 

These equations apply to an ideal gas. 

Equations: 

W = n-RTLN I^J m = n MW 


Example: 

Given: Vi=2_l, Vjf=125_l J T=300_°C, a=0.25_gmol, 

MW =64_g/gmol. 

Solution: W=4926.4942_J, m=.016_kg. 

Polytropic Processes (5, 4) 

These equations describe a reversible pressure-volume change of an 
ideal gas such that P*V n is constant. Special cases include isothermal 
processes (rc^l), isentropic processes (n=k, the specific heat ratio), 
and constant-pressure processes (n=0). 

Equations: 

pf _ [ vf l 11 

Pi “ { Vi J 

Example: 

Given: Pi=15_psi, P/=35_psi, Vi= l_fT3, Vf= 0.50_fT3, Ti=75_°F. 
Solution: n=1.2224, I7=164.1117_°F. 




Isentropic Flow (5, 5) 

The calculation differs at velocities below and above Mach 1. The 
Mach number is based on the speed of sound in the compressible fluid. 



Equations: 


T _ 2 P 

TO “ 2 + (k- 1)-M2 po 

1 

P__ f T_) k^T 

pO l TO J 



A 

At 




k + 1 

T(k^T) 


Example: 

Given: fee* 2, M=.9, T0=26M-°C, T= 373.15-K, p0=lOO_kg/m~3, 
P0=lOO_kPa, A=l_cm~2. 

Solution: P=464.1152_kPa, Af=0.9928_Cm"2, p=215.4333_kg/m"3. 
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Real Gas Law (5, 6} 

These equations adapt the ideal gas law to emulate real-gas behavior. 
(See “ZFACTOR” in chapter 3.) 

Equations: 


P-V = n-Z-R-T m = n • MW 


Example: 

Given: Pc=48_atm, Te=298_K, P=5_kPa, 7=10-1, 
M17=64-g/gmol, T= 75_°C. 

Solution: n=0.0173_gmol, m=1.1057E—3_kg. 


Real Gas State Change (5, 7) 

This equation adapts the ideal gas state-change equation to emulate 
real-gas behavior. (See “ZFACTOR” in chapter 3.) 


Equation: 


Pf Vf _ Pi-Vi 
Zf • Tf “ Zi-Ti 


Example: 

Given: Pe=48_atm. Pi=100_kPa, P/=50_kPa, Ti= 75_°C, 
Tc=298_K, W=10_l, Tf= 250_°C. 

(Remember Zf and Zi are automatically calculated by the HP 48 
using these variables.) 

Solution: 7/=30.1703_l. 
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Kinetic Theory (5, 8) 

These equations describe properties of an ideal gas. 

Equations: 



n-MW *vrms 2 
3*V 


vrms 



3-R-T 

MW 



m = n-MW 


Example: 

Giyen: P=10(EkPa, F=2_l, T=26.85_°C, MW= 18_g/gmol, 
d=2.5_nm. 

Solution: vrms— 644.7678 _m/s, m~1.4433E—3_kg, n=.0802_gmol, 
A=1.4916_nm. 


Heat Transfer (6) 


Variable Names and Descriptions 


a 

Expansion coefficient 

6 

Elongation 

XI ,X2 

Lower and upper wavelength limits 

X max 

Wavelength of maximum emissive power 

AT 

Temperature difference 

A 

Area 

c 

Specific heat 
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Variable Names and Descriptions (continued) 


ebl2 

Emissive power in the range Ai to A 2 

eb 

Total emissive power 

f 

Fraction of emissive power in the range A 1 to A 2 

h,hl jhS 

Convective heat-transfer coefficient 

kjkl , kt , k3 

Thermal conductivity 

L,L1 ,L2,L3 

Length 

m 

Mass 

Q 

Heat capacity 

q 

Heat transfer rate 

T 

Temperature 

Tc 

Cold surface temperature (Conduction), or 

Cold fluid temperature 

Th 

Hot surface temperature, or 

Hot fluid temperature (Conduction + Convection) 

Ti , Tf 

Initial and final temperatures 

U 

Overall heat transfer coefficient 


References: 7, 9. 

Heat Capacity (6, 1) 

Equations: 

Q = m-c-AT Q = m e- f Tf — Ti) 


Example: 

Given: AT=15-°C, Ti= 0_°C, m=10_kg, Q=‘25_kJ. 
Solution: Tf—15-°C, c=.1667_kJ/(kg*K). 
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Thermal Expansion (6, 2) 



H—L—H6K- 


SDLY 

EC:N 

i V 

hF 

*1 

PIC 

*pict! 

EMIT 


Equations: 


6 = a-LAT 


6 — a-L • 



Example: 

Given: AT- 15_°C, L= 10_m, Tf= 25_°C, <5=l_cm. 
Solution: Tt=10_°C, a=6.6667E-5_l/ 0 C. 

Conduction (6, 3) 


-H L 






DL*.' I EC:N 



■♦PICT EMIT 


Equations: 



q = ^Th-TcJ 
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Example: 

Given: Tc= 25_°C, Th= 75_°C, A=12.5_m"2, Z=1.5_cm, 

*=.12_W/(m*K). 

Solution: 9 =5000_W, AT- 50_°C. 


Convection (6, 4) 



Equations: 


q = h-A-AT 


q = h-A- 




Example: 

Given: Te=300_K, A=200_rrT2, A=.005_W/(m'2*K), q- 10_W. 
Solution: AT=10_°C, TA=36.8500_°C. 
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Conduction + Convection (6, 5) 

If you have fewer than three layers, give the extra layers a zero 
thickness and any nonzero conductivity. The two temperatures are 
fluid temperatures—if instead you know a surface temperature, set the 
corresponding convective coefficient to 10 499 . 



Example: 

Given: AT- 35_°C, rA=55J*C, A= 10_m A 2, hi =.05_W/(nT2*K), 

A<?=.05_W/(m A 2*K), LI =3 cm, L2= 5_cm, 13— 3-cm, 
hi =.1_ W/(m*K), *2=.5_W/(m*K), k8=. l_W/(m*K). 

Solution: Tc= 20„°C, £f=0.0246-W/(m^2*K), $=8.5995_W. 
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Black Body Radiation (6, 6) 

See “FOA” in chapter 3. 



Equations: 

eb = <r-T 4 f = FOA | A2;T j - FOA jf Al;Tl 

ebl2 = f eb Amax-T = c3 q — eb-A 


Example: 

Given: T=1000_°C, Ajf=100CLnm 5 Ai?=60CLnm, j4=l_cirT2. 

Solution: Amax=2276.0523_nm, e&—148984/27G3_W/rrT2,/=.0036 
e67i?—537^7264..W/m"2, g^l4,8984_W. 
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Magnetism (7) 


Variable Names and Descriptions 


-j 

fir 

Relative permeability 

B 

Magnetic field 

d 

Separation distance 

Fba 

Force 

IJaJb 

Current 

L 

Length 

N 

Total number of turns 

n 

Number of turns per unit length 1 

r 

Distance from center of wire 

ri , ro 

Inside and outside radii of toroid 

rw 

Radius of wire 


Reference: 3. 

Straight Wire (7,1) 

The magnetic field calculation differs depending upon whether the 
point is inside or outside the wire. 



Equation: 


B — ——- 

2*7r*r 
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Example: 

Given: fir— 1, riu=.25 cm, r=.2_cm, 7=25_A, 

Solution: £=.0016_T. 

Force between Wires (7, 2) 

The force between wires is positive for an attractive force (for currents 
having the same sign). 


Equation: 




/iO‘^r*LIb*Ia 

2 • 7T * d 


Example: 

Given: /a=10_A, 16—20_A, pir— 1, Z=50_cm, rf—l_cm. 
Solution: Fba— 2.0000E—3_N* 

Magnetic (B) Field in Solenoid (7, 3) 
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Equation: 


B = /iO-/ir-I-n 


Example: 

Given: ^r=10, n=50, 1= 1,25_A. 

Solution: B— 0.0785-T. 

Magnetic (B) Field in Toroid (7, 4) 



Equation: 



2*7r 



— ) 

ro + ri ) 


Example: 

Given: //r=10, AT=50, n=5_cm, ro= 7_cm, /—10_A. 
Solution: S=1.6667E-2_T. 
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Motion (8) 


Variable Names and Descriptions 


a 

Angular acceleration 

UJ 

Angular velocity (Circular Motion), or 

Angular velocity at i (Angular Motion) 

u )0 

Initial angular velocity 

P 

Fluid density 

9 

Angular position at t 

60 

Initial angular position (Angular Motion), or 

Initial vertical angle (Projectile Motion) 

a 

Acceleration 

A 

Projected horizontal area 

ar 

Centripetal acceleration at r 

Cd 

Drag coefficient 

m 

Mass 

M 

Planet mass 

N 

Rotational speed 

R 

Horizontal range (Projectile Motion), or 

Planet radius (Escape Velocity) 

r 

Radius 

t 

Time 

V 

Velocity at t (Linear Motion), or 

Tangential velocity at r (Circular Motion), or 

Terminal velocity (Terminal Velocity), or 

Escape velocity (Escape Velocity) 

v 0 

Initial velocity 

vx 

Horizontal component of velocity at t 

vy 

Vertical component of velocity at t 

X 

Horizontal position at t 

xO 

Initial horizontal position 

y 

Vertical position at t 

yO 

Initial vertical position 


Reference: 3. 
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Linear Motion (8,1) 


Equations: 



xO + vO*t + - - a * t 2 


x = xO + v • t — 


-•at 2 

2 





vO + v 



v — vO + a*t 


Example: 

Given: x0= 0_m } x 100_m, 10_s, v0~ l_m/s. 

Solution: fl=19_m/s, a=1.8_m/s''2. 

Object in Free Fall (8, 2) 

Equations: 

1 •> 

y = yO + vO-t- --g-r 

v 2 = v0 2 -2 g- [y-y0) 


1 

y = y0 + V-t + -*g*t 


v — vO — g*t 


Example: 

Given: ^0=lOOO_ft, ?/=0_ft, vO— CLft/s. 
Solution: tf=7.8843_s, v=— 253.6991 _ft/s. 
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Projectile Motion (8, 3) 



Equations: 

x = xO + vO ■ COS | 00 | t 


y 


y0 + vO-SIN ( 


00 I t- - 


vx = vO-COS 00 


vy = vO-SIN | 00 


g-t 


vO 2 

R =-SIN I 2 -00 

g 


Example: 

Given: £0=O~ft, y0=O_ft, 00= 45_°, t>0=2OO_ft/s, t=10_s. 

Solution: R=i243.2399_ft, tw=141.4214_ft/s > «»=-180.3186_ft/s 
z=1414.2136_ft, y=-194.4864_ft. 

Angular Motion (8, 4) 

Equations: 

1 l 

0 = 00 + w0-t + — -a-t 2 0 = 00 + u >-t — — -a-t 2 



0 ° + 1 { 


wO + <jj 




u> — u;0 + a*t 
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Example: 

Given; 00= 0_°, —0_r/min, ol~ l,5_r/rnin"2, 2=30_s. 

Solution; 0=1O.743O_°, a;=*7500_r/rmn. 

Circular Motion (8, 5) 

Equations: 

V V 2 

u> = - ar= — w = 2-7T-N 

r r 

Example: 

Given: r=25_in, z;=250(Lft/s. 

Solution: co— 72000_r/min, ar— 3000000 _ft/V 2, A T —11459.1559_rpm. 

Terminal Velocity (8, 6) 

Equation: 



Example: 

Given: Cd-. 15, /9=.0251b/ft'3, .4=100000_in~2, m=1250_lb. 
Solution: i)=1757.4709_ft/s. 

Escape Velocity (8, 7) 

Equation: 

/2-G-M 

V_ V R 
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Example: 

Given: 1.5E23_lb, R= 5000_mi. 

Solution: 3485,1106_ft/s. 


Optics (9) 


Variable Names and Descriptions 


91 

Angle of incidence 

02 

Angle of refraction 

OB 

Brewster angle 

6c 

Critical angle 

/ 

Focal length 

m 

Magnification 

n.nl ,n2 

Index of refraction 

r,ri ,r2 

Radius of curvature 

u 

Distance to object 

V 

Distance to image 


For reflection and refraction problems, the focal length and radius of 
curvature are positive in the direction of the outgoing light (reflected 
or refracted). The object distance is positive in front of the surface. 
The image distance is positive in the direction of the outgoing light 
(reflected or refracted). The magnification is positive for an upright 
image. 

Reference: 3. 
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Law of Refraction (9, 1) 



SDLV 

! EQN 

'.'liF.S 

PIC -+PICT 

EMIT 


Equation: 

nl SIN (fllj = n2 SIN j 

Example: 

Given: nl — 1, n2— 1.333, 01— 45_°, 

Solution: 02=32. 0367_°. 

Critical Angle (9, 2) 




ECSN I VfiftS PIC l + PICTl EMIT 


Equation: 
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Example: 

Given: nl— 1, n2~ 1.5. 

Solution: 0c=41.81O3~°. 

Brewster’s Law (9, 3) 

The Brewster angle is the angle of incidence at which the reflected 

wave is completely polarized. 



Equations: 

TAN^0b)=^ 0B + 02 = 90 

Example: 

Given: nl~ 1, n2— 1.5. 

Solution: 0£=56.3O99_°, 02=33.6901-°. 

Spherical Reflection (9, 4) 
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Equations 


y 



Example: 

Given: i£=10_cm, ^=300_cm, r—19.35_cm. 
Solution: m=—30, /=9.6774_cm. 


Spherical Refraction (9, 5) 



Equation: 


nl 

— + 
u 


n2 n2 — nl 
v r 


Example: 

Given: u= 8_cm, r=2_cm, »i=l. 

Solution: n2— 1.5000. 
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Thin Lens (9, 6) 

rl is for the front surface, and rS is for the back surface. 



Equations: 


1 

—h 

u 






Example: 

Given: rl = 5_cm, r2— 2CLcm, n—1.5, w—50_cm. 
Solution: /= 13.3333-cm, u=18,1818_cm, .3636. 


Oscillations (10) 


Variable Names and Descriptions 


UJ 

Angular frequency 

0 1 

Phase angle 

6 

Cone angle 

a 

Acceleration at t 

f 

Frequency 

G j 

Shear modulus of elasticity 

h 

Cone height 


i 
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Variable Names and Descriptions (continued) 


/ 1 

Moment of inertia 

J 

1 Polar moment of inertia 

k 

Spring constant 

L 

i Length of pendulum 

m 

Mass 

t 

rp* 

lime 

T 

Period 

V 

Velocity at t 

X 

Displacement at t 

xm 

Displacement amplitude 


Reference: 3. 

Mass-Spring System (10,1) 



Equations: 





Ui ~ 2 • 7T 'f 


Example: 


Given: i=20_N/m 


m 


5-kg 


Solution: a;—2_r/s. T=3.1416_s./=.3183_Hz. 
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Simple Pendulum (10, 2) 




E> 


li F; l" 

PIC 

•+PICT 



Equations: 





U! = 2'7T *f 


Example: 

Given: £=15_cm. 

Solution: w=8.0856_r/s, T=.7771_s, /=1.2869_Hz. 


Conical Pendulum (10, 3) 



Equations: 



h = L-COS f 0 j 

UJ — 2 • 7T • f 
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Example: 

Given: L— 25_cm, ft=20_cm. 

Solution: 0=36.899.°, T=.8973_s, w=7.0024_r/s, /=1.1145_Hz. 

Torsional Pendulum (10, 4) 



Equations: 




U = 2-7T-f 


Example: 

Given: G=1000.kPa, J=17_mm"4, i=26_cm, /=50_kg*m~2. 
Solution: w=1.1435E-3_r/s, /=1.8200E-4_Hz, T=5494.4862_s. 

Simple Harmonic (10, 5) 

Equations: 

x - xm-COS (o>-t + <^ J v = —w-xm-SIN fw-t + <j> 

a = — u> 2 -xm-COS f u >-t + <j> 1 o> = 2-7r-f 
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Example: 


Given: xm=10_cm, w=15_r/s, ^=25_°, i=25_/zs. 

Solution: x=9.0615_cm, 0.6344_m/s, a=—20.3884_m/s - '2, 

/=2.3873_Hz. 


Plane Geometry (11) 


Variable Names and Descriptions 


0 

Centra] angle of polygon 

e i 

Vertex angle of polygon 

A , 

Area 

b 

Base length (Rectangle, 'Priangle), or 

Length of semiaxis in x direction (Ellipse) 

c | 

Circumference 1 

d 

Distance to rotation axis in y direction 

h 

Height (Rectangle, Triangle), or 

Length of semiaxis in y direction (Ellipse) 

I,Ix 

Moment of inertia about x axis 

Id 

Moment of inertia in x direction at d 

iy 

Moment of inertia about y axis 

j 

Polar moment of inertia at centroid 

L 1 

Side length of polygon 

71 

Number of sides 

P 

Perimeter 

r 

Radius 

ri , ro 1 

Inside and outside radii 

rs 

Distance to side of polygon 

rv 

Distance to vertex of polygon , 

1 V 

___ 

Horizontal distance to vertex 


Reference: 4. 
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Circle (11,1) 



Equations: 



C = 2-7r-r 






Id = I 4- Ad 2 


Example: 

Given: r—5_cm, d= 1.5_cm. 

Solution: (7=31.4159-011, A— 78.5398_.cnr2, /=4908738.5_.mm"4, 
/=9817477.0_mm"4, Ji=6675884.4_nrnT4. 

Ellipse (11, 2) 
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Equations: 

A - 7r b h 

J = ^^[ b 2 + h 2 J Id = I + A-d 2 

Example: 

Given: 6=17.85_jUm, h= 78.9725_/dn, d= .00000012_ft. 

Solution: A=1.1249E—6_cm"2, C=7.9805E—3_cm, 

7=1.1315E—10_rmn''4, /=9.0733E-9_mm'4, Id= 1.1330E-10_mm 

Rectangle (11, 3) 



Equations: 

i i 3 

A = b-h P = 2-b + 2-h I = — 

12 

I* 

J = y^(b 2 + h2 j Id = I + A-d 2 

Example: 

Given: 6=4^chain, h= 7_rd, d=39.26„in. 

Set guesses for /, J, and Id in km"4. 

Solution: A=28328108.2691_cnT2, P=23134.3662_cm, 
7=2.9257E—7_km A 4, /=1.8211E-6 JmE4, Jd=2.9539E-7_km"4. 
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Regular Polygon (11, 4) 



rs K- 8 



T 

L 

* 



EC:N I ms 




*Pl£Tl E 



Equations: 



P = n-L 



rv 




Example: 

Given: n=8, Z=.5_yd. 

Solution: ^4=10092.9501_cm"2, P=365.7600_cm, rs=55.1889_cm, 
n;=59.7361_cm, 0=135_°, /?=45_°. 


Circular Ring (11, 5) 
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Equations: 



J = ^ • f ro 1 — ri 4 1 Id = 1 + A d 2 


Example: 

Given: ro=4_//, r»=25.0_kA, d=.l_mil. 

Solution: A=3.0631E-7_cm~2, /=I.7038E-10_mm“4 > 
J=3.4076E—10_mm'‘4, /</=3.0648E-10-mnT4. 

Triangle (11, 6) 



J = —^ • ^h 2 + b 2 — b-v + v 2 1 Id = lx+ A*d 2 
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Example: 

Given: A=4.33012781892_in, i>=2.5_in, P=15_in, d= 2_in. 

Solution: 6=5.0000-in, 7r=11.2764_in''4, 7y=11.2?64_irP4, 
7=22.5527JiT4, 7l=10.8253_in'2, 7<f=54.5776_in*4. 


Solid Geometry (12) 


Variable Names and Descriptions 


A 

Total surface area 

6 

Base length 

d 

Distance to rotation axis in 2 direction 

h 

Height in 2 direction (Cone, Cylinder), or 

Height in y direction (Parallelepiped) 

I Jxx 

Moment of inertia about x axis 

Id 

Moment of inertia in x direction at d 

Izz 

Moment of inertia about M axis 

m 

Mass 

r 

Radius 

i 

Thickness in 2 direction 

V 

Volume 


Reference: 4. 
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Cone (12, 1) 



Id = Ixx + m-d 2 


Example: 

Given: r= 7^cm, A=12.5_cm ? ra—12.25._kg, d— 3.5_em. 

Solution: V =64L4085_cnT3, /l =468.9953_cm 2, Ixx— 0.0162_kg*m"2, 
/2£=0.0180_kg*rrT2, Id— 0.0312_kg*nT2. 

Cylinder (12, 2) 
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Equations: 


V = 7r-r 2 -h A = 2-7r-r 2 + 2-7r-r-h 



J- O 

- *rn r + 

4 






*m*r 



Id = Ixx + md 2 


Example: 

Given: r= 8.5_in, A=65_in, m=12000_lbs, rf=2,5_in. 

Solution: F=14753.7045_iiT 3, ^=3925*4200_in A 2, 

/z£=4441750Jb*irT2, /*z=433500Jb*iiT2, /d=4516750_lb*in~2. 


Parallelepiped (12, 3) 



Equations: 


V = bht 


A = 2 ■ 


b * h — I - Id ■ -f ht 




Id = I + md 2 
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Example: 

Given: 6=36_in, A=12_in, /=72_in, m=83_lb, d=7_in. 
Solution: K=31104_in‘'3, yl—7776_iri 2. /=36852_lb*in~2, 

74=40919_lb*in" 2. 

Sphere (12, 4) 



Equations: 



A . = 4-7T’r 2 



- -m*r 

5 


Id — I + m-d 2 


Example: 

Given: d—14_cm, m=3.75Jkg, Id— 486,5_lb*in 2. 

Solution: r=21.4273_cm, V=41208.7268_cm~3, A=5769.5719-crrT 2, 
/r=0.0689 _kg*m"2. 
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Solid State Devices (13) 


Variable Names and Descriptions 


aF 

Forward common-base current gain 

otR 

Reverse common-base current gain 

7 

Body factor 

A 

Modulation parameter 

jlM 

Electron mobility 

<1>p 

Fermi potential 

AL 

Length adjustment (PN Step Junctions), or 


Channel encroachment (NMOS Transistors) 

AW 

Width adjustment (PN Step Junctions), or 


Width contraction (NMOS Transistors) 

a 

Channel thickness 

Aj 

Effective junction area 

BV 

Breakdown voltage 

Cj 

Junction capacitance per unit area 

Cox 

Silicon dioxide capacitance per unit area 

El 

Break down-volt age field factor 

Emax 

Maximum electric field 

GO 

Channel conductance 

gds 

Output conductance 

gm 

Transconductance 

I 

Diode current 

IB 

Total base current 

IC 

Total collector current 

ICEO 

Collector current (collector-to-base open) 

ICO 

Collector current (emitter-to-base open) 

ICS 

Collector-to-base saturation current 

ID,IDS 

Drain current 

m 

Total emitter current 

IES 

Emitter-to-base saturation current 
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Variable Names and Descriptions (continued) 


IS 


Js 


Le 

NA 


ND 


T 

tox 

Fa 

VBC 

VBE 

Vbi 

VBS 

VCEsat 

VDS 

VDsat 

VGS 

Vi 

vto 

w 


We 

xd 

xdmax 

xj 


Transistor saturation current 

Current density 

Saturation current density 

Drawn mask length (PN Step Junctions), or 
Drawn gate length (NMOS Transistors), or 
Channel length (JFETs) 

Effective gate length 

P-side doping (PN Step Junctions), or 
Substrate doping (NMOS Transistors) 

N-side doping (PN Step Junctions), or 
N-channel doping (JFETs) 

Temperature 

Gate silicon dioxide thickness 
Applied voltage 
Base-to-collector voltage 
Base-to-emitter voltage 
Built-in voltage 
Substrate voltage 

Collector-to-emitter saturation voltage 
Applied drain voltage 
Saturation voltage 
Applied gate volt age 
Threshold volt age 

Threshold voltage (at zero substrate volt age) 

Drawn mask width (PN Step Junctions), or 
Drawn width (NMOS Transistors), or 
Channel width (JFETs) 

Effective width 
Depletion-region width 

Depletion-layer width 
Junction depth 


References: 5, 8. 
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PN Step Junctions (13, 1) 

These equations for a silicon PN-junction diode use a “two-sided 
step-junction” model—the doping density changes abruptly at the 
junction. The equations assume the current density is determined 
by minority carriers injected across the depletion region and the PN 
junction is rectangular in its layout. The temperature should be 
between 77 and 500 K. (See “SIDENS” in chapter 3.) 



?0LV ECiN hF;S PIC *PICT| EMIT 
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Equations: 


k-T TAT fNA ND 
Vbi =-LN 


q 


m 


xd 



2-esi-eO 

q 


(Vbi - Va) 



+ 


1 


ND 


Cj 


esi * eO 
xd 


Emax 


2.1 Vbi - Va 

xd 


BV 


esi-eO-El 2 

2-q 


1 1 

+ 


NA ND 


J = Js * 


q-Va 

¥t 


i 


Aj 


W + 2-AW 


L + 2AL 


+ 7T- W + L + 2AW + 2AL -xj + 2-irxj 


1 = J Aj 


Example: 

Given: AD=lE22_cm'-3, AA=lE15_l/enE3, T=26.85_°C, 
/s=lE—6_/uA/cnT2, Ea=-20JV, Ai=3.3E5_V/cm, W=10-H, 
AW—\-H, L— 10_/x, AL—l-fi, xj— 

Solution: Vbi=.9 962_V, xd— 5.2551_/l<, <7j=2005.0141_pF/cm“2, 
Ema*=79908.5240_V/cm, BV= 358.0825._V, /=-1.0E-12_A/cm~2, 
Ay=3.1993E—6_cm"2, 7=-3.1993E-15_mA. 
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NMOS Transistors (13, 2) 

These equations for a silicon NMOS transistor use a two-port 
network model. They include linear and nonlinear regions in 
the device characteristics and are based on a gradual-channel 
approximation (the electric fields in the direction of current flow are 
small compared to those perpendicular to the flow). The drain current 
and transconductance calculations differ depending on whether the 
transistor is in the linear, saturated, or cutoff region. The equations 
assume the physical geometry of the device is a rectangle, second-order 
length-parameter efFects are negligible, short-channel, hot-carrier, and 
velocity-saturation effects are negligible, and subthreshold currents are 
negligible. (See “SIDENS Function” in chapter 3.) 
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Equations: 


eox• tO 


We: 

= W - 2A 

.W 

Le = L - 2-AL Cox = 

tox 

IDS = 

Cox-fm' f 

We' 

Le J 

i ( VDS 2 ^ 

• (VGS - Vt)* VDS-— 1 (1 + A-VDS) 




^2-esi-eO-q-NA 



/ 

' Cox 

Vt 

= VtO + 7 

(v 

r 2-ABS(>p) -1- ABS(VBS) - y^-ABS^p) 1 


# = 

—k-T T , T ( NA A , , 

LN . gds = IDS • A 

q v ni ; 


gm = y 

1 Cox-fm- ^1 + A-VDs) - 2-IDS 




VDsat. = VGS - Vt 


Example: 


Given: tox— 700-A, Ai4=lE15-.l/cirT3, /in=600-cm"2/(V*s), 
T=26.85_°C, VfO=. 75_V, VG5=5_V, VB5=0_V, VDS= 5_V, 
EK=25_a*, A W=l-p, £=4_m, A5=.75_jU, A-05 1/V. 

Solution: IVe=23_/i, Le=2.5_/i, Co£=49330.4750_pF/cm~2, 
7=.3725_V\5, <£p=-.2898-V, W=.75_V, VDsaf=4.25_V, 
77)5=3.0741 mA, 0*=1.537OE-4_S, flim=1.4466_mA/V. 
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Bipolar Transistors (13, 3) 

These equations for an NPN silicon bipolar transistor are based 
on large-signal models developed by J.J. Ebers and J.L. Moll. The 
offset-volt age calculation differs depending on whether the transistor 
is saturated or not. The equations also include the special conditions 
when the emitter-base or collector-base junction is open, which are 
convenient for measuring transistor parameters. 



Equations 




' q-VBE 

> 


' q-VBC 

\ 

IE 

= -IES • j 

k-T 

e 

p 

-1 

+ aR ICS ■ 

k-T 

e 

-1 



k 

> 


k. 

J 



q VBC 



r q VBE 

> 

IC 

= -ICS • ; 

k-T 

e 

k 

- 1 : 

J 

+ aF-IES • 

k-T 

e 

L 

-1 

IS - 

aFIES 

IS = 

= aRICS 

IB + IE + IC : 


0 


ICO = ICS • 1 - aF'ftR 


ICEO 


ICO 


1 - aF 


k-T 

VCEsat =-LN 

q 


1 + 


IC 

IB 


1 — aR 


aR • I 1 


IC 

IB 


1 -aF 
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Example: 

Given: IES~ lE-5_nA, /C5=2E-5_nA, T-26.85_°C, aF=. 98, 
aR=. 49, IC= l_mA, ESC^-IO-V. 

Solution: VBE=M53-V, /5=0.0000098_nA, /CO=.000010396_nA, 
/CEO=.0005198_nA, 7E=-1.0204_mA, /5=.0204_mA, VCEsai=Q-Y. 

JFETs (13, 4) 

These equations for a silicon N-channel junction lield-effect transistor 
(JFET) are based on the single-sided step-junction approximation, 
which assumes the gates are heavily doped compared to the channel 
doping. The drain-current calculation differs depending on whether 
the gate-junction depletion-layer thickness is less than or greater than 
the channel thickness. The equations assume the channel is uniformly 
doped and end effects (such as contact, drain, and source resistances) 
are negligible. (See “SIDENS” in chapter 3.) 
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Equations: 


k-T f ND 
Vbi =-LN 


q 


m 


xdmax 



2 • esi • eO 
q • ND 


Vbi - VGS + VDS 


( a • W 

——— I 


ID =GQ • I VDS - 2 • J 2 ’ ”' % 

3 V q • ND • a 2 



Vbi - VGS + VDS 


Vbi - VGS 


3 

2 



VDsat = ^ ND - (Vbi - VGS) 

2 • esi • eO 


Vt = Vbi 


q • ND • a' 
2 ■ esi• eO 


gm — GO * I 1 



2 * 6S1 * £0 

———-(Vbi-VGS) 

q • ND • a 2 k ') 


Example: 

Given: jVZ)=lE16_l/cm~3, W= 6^//, a=l_^, L= 2_/u, 
/in=1248_cm"2/(V*s), VGS=-4-Y, VDS= 4_V, r=26.85^°C. 

Solution: V6i=.3493_V, xdmax=1.0479-fjt, (70=5.9986E—4_S, 

ID=. 2268_mA, VDsat=3,2bZ7-V, Vt=- 7.2537-V, gm=. 1462_mA/V. 
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Stress Analysis (14) 



al 

(T 2 

aavg 

ax 

axl 

ay 

ayl 


rmax 

rxlyl 

rxy 


Opl 

6p2 

6s 


E 

G 


P 


T 


Elongation 
Normal strain 
Shear strain 
Angle of twist 
Normal stress 

Maximum principal normal stress 

Minimum principal normal stress 

Normal stress on plane of maximum shear stress 

Normal stress in x direction 

Normal stress in rotated-;? direction 

Normal stress in y direction 

Normal stress in rotated -y direction 

Shear stress 

Maximum shear stress 

Rotated shear stress 

Shear stress 

Rotation angle 

Angle to plane of maximum principal normal stress 
Angle to plane of minimum principal normal stress 
Angle to plane of maximum shear stress 
Area 

Modulus of elasticity 

Shear modulus of elasticity 

Polar moment of inertia 

Length 

Load 

Radius 

Torque 


Reference: 2. 
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Normal Stress (14,1) 


p H I h p 

H— L —H6K- 


SDL 1 . 1 EtfN rt F; < PIC -+PICT EMIT 


Equations: 

(7 = E-f 




p 

A 


Example: 

Given: P=40000Jbf, L= l_ft, A=3.14159265359_iiT2, P=10E6_psi. 
Solution: <$=0.0153_m, e=0.0013, cr=12732.3954_psi. 


Shear Stress (14, 2) 



Equations: 


r = G '7 
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Example: 

Given: Z=6_ft, r=2_in, J=10.4003897419_in~4, (7=12000000 

r=12000_psi. 

Solution: T=5200.1949_ft*lbf, <£=2.0626_°, 7=5.7296E-2_°. 

Stress on an Element (14, 3) 

Stresses and strains are positive in the directions shown. 





EClN 

VrtftS 

PIC 

*PICT 


Equations: 


<7x1 = " X ±-" y - + ■ COS(2.0) + rxy-SIN(2-(?) 


2 


2 


crxl + cry 1 = rrx + cry 


rxlyl = — 



Example: 

Given: <r:r™15000_kPa ? crt/=4755_kPa, T£2/:=7500_kPa, 9— 30_ 

Solution: crxl = 18933.9405_kPa, cryl — 821.0595„kPa, 
rxlyl 686.2151_kPa. 
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Mohr’s Circle (14, 4) 


<<TY,-x.KV) 


X-MIN 



VMAK 


E 0 . N 

VhF 

i i I 

a 1 

i _■ 

PIC 

•+PICT 



Equations: 


ax + ay 

=—j—+ 



( crx - <ry ^ 2 

+TXy 


crl + cr2 = <rx + cy 


SIN(2-0pl) 


rxy 


f ax - ay ) 

I 2 J +TXy 



0p2 = 0pl + 90 


rmax 


<xl — <j2 

2 


0s = 0pl — 45 


cravg 


crx + cry 

2 


Example: 

Given: ax—— 560Q_psi, ay=— 18400_psi. r^=4800_psi. 

Solution: at—— 4000_psi. a2—— 20000_psi } = 18.4349-°, 

0p2— 108.4349_°, rmax— 8000_psi, Os—— 26.5651-°, aavg—— 12000-psi, 
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Waves (15) 


Variable Names and Descriptions 


0 

Sound level 

A 

Wavelength 

U) 

Angular frequency 

p 

Density of medium 

B 

Bulk modulus of elasticity 

f 

Frequency 

I 

Sound intensity 

k 

Angular wave number 

s 

Longitudinal displacement at x and t 

sm 

Longitudinal amplitude 

t 

Time 

V 

Speed of sound in medium (Sound Waves), or 

Wave speed (Transverse Waves. Longitudinal Waves) 

X 

Position 

y 

Transverse displacement at x and t 

ym 

Transverse amplitude 


Reference: 3. 

Transverse Waves (15, 1) 
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Example: 

Given: ym— 6.37_cm, &=32.11_r/cm, a;=.03-cm, a;=7000-r/s, t= l_s. 
Solution: /=1114.0846_Hz ? A=.0020-_cm, y— 2.6655-cm, 

i ; =218.0006 -cm / s. 

Longitudinal Waves (15, 2) 


Equations: 


s = sm-COS 




LO — 2 • 7T • f 


Example: 

Given: sm=6.37-cm, fc=32.11_r/cm, r—.03_cm, 7000_r/s, f=l_s. 

Solution: s=5.7855_crn, ^2.1800_m/s, A=.1957_cm, 
/=1114.0846_Hz. 


Sound Waves (15, 3) 


Equations: 





P • V • U) 



(3 = 10-LOG [ij 


U - 2*7T*f 


Example: 

Given: sm=10_cm. w=6000_r/s, £=12500_kPa, /?=65_kg/nT3. 

Solution: i>=438.5290_m/s, 7=5130789412.97_W/m'2, 
/?=217.1018_dB, /=954.9297_Hz. 
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Error and Status Messages 

In the following tables, messages are first arranged alphabetically by 
name and then numerically by message number. 


Messages Listed Alphabetically 


Message 

Meaning 

# (hex) 

Acknowledged 

Alarm acknowledged. 

' 619 ' 

Axl V 3 ri3b1es 

Known 

No unknowns to slove for. 

E405 I 

Auioscali hq 

Calculator is autoscaling x- 
and/or y- axis. 

1 610 

A w a i t i n g S e r w e r 

C n d. 

Indicates Server mode active. 

' COC 

B a d A r g u r- i e n t Type 

One or more stack arguments 
were incorrect type for 
operation. 

202 

Bad Argument. Value 

Argument value out of i 

operation’s range. 

203 

Bad Guess(es) 

Guess(es) supplied to HP Solve 
application or ROOT lie 
outside domain of equation. 

A01 | 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

Bad Packet Block 
c h e c k 

Computed packet checksum 
doesn’t match checksum in 
packet. i 

C01 

Can't Edit Hull 

L h a r n 

Attempted to edit a string 1 

containing character » 

(character code 0). 

102 

Circular Reference 

Attempted to store a variable 
name into itself. 

129 

Connecting 

Indicates verifying IR or serial 
connection. 

COA 

C o n s t a n t ? 

HP Solve application or ROOT 
returned same value at every 
sample point of current 
equation. 

A02 

C o pied t o s i a c k 

• copied selected 

. -s-, *-++"-« «■■«- 

623 


equation to stack. 


Current equation « 

Identifies current equation. 

608 

Deleting Column 

Matrix Writer application is 
deleting a column. 

504 

Deleting R o w 

MatrixWriter application is 
deleting a row. 

503 

Directory Not 

Pi 11 o w e d i 

Name of existing directory 
variable used as argument. 

12 A 

Direct ory 

Recursion 

Attempted to store a directory 
into itself. 

002 

Empty catalog 

No data in current catalog 
(Equation, Statistics, Alarm). 

60D 

Em p t y st ack 

The stack contains no data. 
_ 

C15 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

Enter a lam? 
press SET 

Alarm entry prompt. 

61A 

Enter eqn, press 

HEW 

Store new equation in EQ, 

60A 

Enier va 1 ue ( zoom 
out if )' 1) ? press 
ENTER 

Zoom operations prompt. 

622 

EQ Invalid for 

MINI! 

EQ must contain at least two 
equations (or programs) and 
two variables. 

E403 

Extrenun 

Result returned by HP Solve 
application or ROOT is an 
extremum rather than a root. 

A06 

HALT Hot Allowed 

A program containing HALT 
executed while MatrixWriter 
application, DRAW, or HP 

Solve application active. 

126 

I/O setup nenu 

Identifies I/O setup menu. 

61C 

Illegal During 

MROQT 

Multiple-Equation Solver, 
command attempted during 
MROOT execution. 

E406 

Inp licit O off 

Implicit parentheses off. 

207 

Implicit O on 

Implicit parentheses on. 

208 

Inconp1et e 

S u b e x pres s i o n 

(►L fT|, or (ENTER! pressed 
before all function arguments 
supplied. 

206 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

1nconsistent Units 

Attempted unit conversion 
with incompatible units. 

B02 

Inf irate? Result 

Math exception: Calculation 
such as 1/0 infinite result. 

305 

Inserting Colunn 

Matrix Writer application is 
inserting a column. 

506 

I riser t i ng Rau 

Matrix Writer application is 
inserting a row. 

505 

I n s u f f i c i e n t 

M e n o r u 

Not enough free memory to 
execute operation. 

001 

Insufficient I 

D t d 

A Statistics command was 
executed when 2DAT did not 
contain enough data points for 
calculation. 

603 

Interrupted 

The HP Solve application or 
ROOT was interrupted by 

A03 


[CANCEL]. 


Inualid Array 
Element 

[ENTER 1 returned object of 
wrong type for current matrix. 

502 

I n v a 1 i d C a r d D a t a 

HP 48 does not recognize data 
on plug-in card. 

008 

I ny a 3. i d D a t e 

Date argument not real 
number in correct format, or 
was out of range. 

DO 1 

I n y a 1 i d D e f i n i t i o n 

Incorrect structure of equation 
argument for DEFINE. 

12C 

I n y a 1 i d D i m e n s i o n 

Array argument had wrong 
dimensions. 

501 


A-4 Error and Status Messages 







Messages Listed Alphabetically (continued) 

Message Meaning j # (hex) 

Invalid EQ Attempted operation from 607 

PICTURE FCN menu when 
EQ did not contain algebraic, 
or, attempted DRAW with 
CONIC plot type when EQ 

did not contain algebraic. 


Invalid IOPflR 10PAR not a list, or one or C12 

more objects in list missing or 
invalid. 

Invalid Mpar Mpar variable not created by E401 

MINIT. 

I nva lid Name Received illegal filename, or (T7 

server asked to send illegal 
filename. 

Inval id FPflR PPAR not a list, or one or 12E 

more objects in list missing or 
invalid. 

Inva 1 id PRTPRR PRTPAR not a list, or one or C13 

more objects in list missing or 
invalid. 

Inval id PTYPE Plot type invalid for current 620 

equation. 

Inva lid Repeat Alarm repeat interval out of D03 

range. 

Inval id Server Invalid command received C08 

Cnd„ while in Server mode. 

Inval id Syntax HP 48 unable execute (ENTER 1 , 106 

OBJ—or STR—* due to 
invalid object syntax. 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

Invalid Tine 

Time argument not real 
number in correct format, or 
out of range. 

D 02 

I n o a 1 i d U n i 4 

Unit operation attempted with 
invalid or undefined user unit. 

B01 

Ina 1 id User 

Type or structure of object 

103 

F u n c t i o n 

executed as user-defined 



function was incorrect. 


Invalid E Data 

Statistics command executed 
with invalid object stored in 

EDAT. 

601 

Invalid I Data 

Non-linear curve fit attempted 

605 

L H <H e 9 > 

when EDA T matrix contained 
a negative element. 


Inwalid E Data 

Non-linear curve fit attempted 

606 

L N < 01 

when E DAT matrix contained 
a 0 element. 


Inualid SPAR 

EPAR not list, or one or more 
objects in list missing or 
invalid. 

604 

K e y 1.-.1 o r d C o n f 1 i c t 

A plug-in card conflicts with 
an equation library variable. 
Remove the card to continue. 

E303 

LAST CMD D1sab 1ed 

(rHfCMDl pressed while that 
recovery feature disabled. 

125 

LAST STACK 

(r*)(llNDO) pressed while that 

124 

Disab 1 ed 

recovery feature disabled. 


; 

LASTRRG Disabled 

! 

frHfARGl executed while that 
recovery feature disabled. 

205 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

Low Baitery 

System batteries too low to 
safely print or perform I/O. 

C14 

M e Pi o r y C1 ear 

HP 48 memory was cleared. 

005 

Mama Conf1ict 

Execution of | (where) 
attempted to assign value to 
variable of integration or 
summation index. 

13C 

Name tha aquat ion? 
press ENTER 

Name equation and store it in 

EQ. 

60B 

Nana the siat 
daia ? press ENTER 

Name statistics data and store 

it in EDAT. 

621 

Ne 9 atiua Underf 1ow 

Math exception: Calculation 
returned negative, non-zero 
result greater than —MINR. 

302 

; No Current 

Equation 

ami*, DRAW, or RCEQ 

executed with nonexistent EQ. 

104 

No current 
equation. 

Plot and HP Solve application 
status message. 

609 

No Picture 
fly ailabia 

No picture is included for the 
selected equation. 

E304 

N o R o o p‘i i n P o r t 

Insufficient free memory in 
specified RAM port. 

00B 

N o R o o r-'i t o S a m a 

C 1 1 -d L r". 

Not enough free memory to 
save copy of the stack. LAST 

STACK is automatically 
disabled. 

101 


Error and Status Messages A-7 









Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

No Ro 0 m to Show 

Cf s.-L-- 

'J V p d *— ! -- 

Stack objects displayed by 
type only due to low memory 
condition. 

131 

No stat data to 

plot 

No data stored in SDAT . 

60F 

Non-Empty 

D i r e c t o r y 

Attempted to purge non-empty 
directory. 

12B 

Non-Rea1 Resu1t 

Execution of HP Solve 
application, ROOT, DRAW, or 

1 returned result other than 
real number or unit. 

12F 

, 

j 

Norlex i stent R1 arn 

Alarm list did not contain 
alarm specified by alarm 
command. 

D04 

Nonexistent 2DRT 

Statistics command executed 
when UDAT did not exist. 

602 

Object Discarded 

Sender sent an EOF (Z) packet 
with a “D” in the data field. 

COF 

0bj ect In Use 

Attempted PURGE or STO 
into a backup object when its 
stored object was in use. 

009 

Object Not in Port 

Attempted to access a 
nonexistent backup object or 
library. 

ooc 

<0FF SCREEN > 

Function value, root, 
extremum, or intersection was 
not visible in current display. 

61F 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

0 u t o f M e n o r y 

One or more objects must be 
purged to continue calculator 
operation. 

135 

0 \j |g {■- f \ i“i 1,1 

Math exception: Calculation 
returned result greater in 
absolute value than MAXR. 

303 

Packet # 

Indicates packet number 
during send or receive. 

CIO 

Parity Error 

Received bytes’ parity bit 
doesn’t match current parity 
setting. 

C05 

Plot Types 

Label introducing current plot 
type. 

6 ID 

Port Closed 

Possible I/R or serial hardware 
failure. Run self-test. 

C09 

Port Hot fiuai1ah1e 

Used a port command on an 
empty port, or one containing 
ROM instead of RAM. 

00A 


Attempted to execute a server 
command that itself uses the 
I/O port. 


Pos i t i ye Underf 1 ow 

Math exception: Calculation 
returned positive, non-zero 
result less than MINR. 

301 

P o w e r L o —■ t 

Calculator turned on following 
a power loss. Memory may 
have been corrupted. 

006 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

Processing Copland 

Indicates processing of host 
command packet. 

Cll 

P r ci t o c o I Err o r 

Received a packet whose length 
was shorter than a null packet. 

C07 


Maximum packet length 
parameter from other machine 
is illegal. 


Receive Buffer 

Overrun 

Eermit: More than 255 bytes 
of retries sent before HP 48 
received another packet. 

C04 


SRECV: Incoming data 
overflowed the buffer. 


Receiue Error 

UART overrun or framing 
error. 

C03 

Receiving 

Identifies object name while 
receiving. 

COE 

Retry # 

Indicates number of retries 
while retrying packet exchange. 

COB 

y © 1 e c t a Pi o del 

Select statistics curve fitting 
mo del. 

614 

B e 1 e c t p 1 o t t y p e 

Select plot type. 

60C 

■z» 0 1 eci repeat 

i n t e r u' a 1 

Select alarm repeat interval. 

61B 

Sending 

Identifies obj ect name while 
sending. 

COD 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

Sign Reversal 

HP Solve application or ROOT 
unable to find point at which 
current equation evaluates to 
zero, but did find two 
neighboring points at which 
equation changed sign. 

1 A05 

Single Equation 

Only one equation supplied to 
Multiple-Equation Solver. Use 
HP Solve application. 

E402 

T i neoui 

Printing to serial port: 

Received XOFF and timed out 
waiting for XON, ! 

C02 


Kermit: Timed out waiting for 
packet to arrive. , 


Too Few Arguments 

Command required more 
arguments than were available 
on stack. 

201 

Too Many Unknowns i 

Multiple Equation Solver can’t 
calculate a value given the 
current knowns. Supply 
another value or add an 
equation. 5 

E404 

% 

Transfer Fai1ed 

Ten successive attempts to 
receive a good packet were 
unsuccessful. 

C06 

Unable to find 
r o o t 

PROOT is unable to determine 
all roots of the polynomial. 

C001 

Unab1e to Isolate 

1SOL failed because specified 
name absent or contained in 
argument a function with no 
inverse. 

130 
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Messages Listed Alphabetically (continued) 


Message 

Meaning 

# (hex) 

Undefined Local 

Name 

Executed or recalled local 
name for which corresponding 
local variable did not exist. 

003 

Undefined Mane 

Executed or recalled global 
name for which corresponding 
variable does not exist. 

204 

Undefined Resu11 

Calculation such as 0/0 
generated mathematically 
undefined result. 

304 

Undefined XL IB 

M a n e 

Executed an XLIB name when 
specified library absent. I 

004 

Narnings 

Label introducing current 
status message. 

007 

Nr 009 Hrgorient 

Count : 

User-defined function 
evaluated with an incorrect 
number of parenthetical 
arguments. 

128 

x and y-ax is zoom. 

Identifies zoom option. 

627 

x ax is z oo m u 

Identifies zoom option. 

625 

x axis zoom 

wxfiUTO u 

Identifies zoom option. 

624 

y a x is z oo r-i „ 

Identifies zoom option. 

626 

^ E R u 

Result returned by the HP 

Solve application or ROOT is a 
root (a point at which current 
equation evaluates to zero). 

A04 

11 H 

Identifies no execution action 
when 1SEIIB pressed . 

■ ■ rn ■ rrti ■*- 

61E 
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Messages Listed Numerically 


i # (hex) 

Message 

General Messages 

001 

Insuff i c ient Memory 


Direetory Recursion 


Undefined Loca1 Name 

004 

Undef i ned XL I B Name 

005 

Memory Clear 

006 

Power Lost 

008 

Inoa lid Card pata 

009 

Object In use 

00A 

Port Not Available 

00B 

No Room in Port 

OOC 

Object Not in Port 

101 

q R o o n t* o b -3 u 0 t* c k 

102 

Can't Edit Null Char. 

103 

Invalid User Function 

104 

No Current Equation 

106 

Invalid Syntax 

124 

LAST STACK Disabled 

125 

LAST CMD Disabled 

126 

HALT Not Allowed 

128 

Wrong Argument Count 

129 

Circu1ar Reference 

12A 

Dire c t o r y N o t All o w e d 

12B 

N o n - E m p t y D i r e c t o r y 

12C 

Invalid Definition 

12E 

Invalid PPAR 

1 12F 

Non-Real Result 

130 

sUnab1e to Isolate 

i 

131 

Ho Room to Show Stack 

Out-of-Memory Prompts 

135 

Out of Memory 

13C 

Name Conf1ict 
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Messages Listed Numerically (continued) 


# (hex) 

Message 

Stack Errors 

201 

Toci Fe i.-.i Rr 91 jments 

1 202 

B a d H r 9 u m 0 n t T y p 0 

203 

B a d R r 9 u m 0 n t V a 1 u 0 

204 

Undefined Mane 

205 

LHSTflRG Disabled 

Equation Writer Application Messages 

206 

Inconp1 et e Subexpression 

207 

Implicit O off 

' 208 

Implicit O on 

Floating-Point Errors 

301 

PositiMe Underf1ow 

1 302 

N e 9 a t i m 0 U n d e r f 1 0 w 

303 

0 m 0 r f 1 0 w 

304 

Undefined Result 

305 

Infinite Result 

Array Messages 

1 501 

In m alid Dimension 

502 

I n w a 1 i d Array E1 0 m e n t 

503 

Deletinn Row 

hm 

504 

De1eting Co1umn 

505 

Inserting Row 

506 1 

I risert i ng Co 1 umn 

Statistics Messages 

601 

In m alid 2 Dat a 

602 

Nonexistent ZDAT 

603 

Insufficient 2 Data 

604 

Invalid 2PRR 

605 

Invalid 2 Dat a LN'■ N 09 > 

606 

I n m a 1 i d 2 D a t a L N < 8 > 


■ 
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Messages Listed Numerically (continued) 


# (hex) 

Message 

Plot, 

I/O, Time and HP Solve Application Messages 

607 

Invalid EQ 

608 

Current equaiions 

609 

No current equation» 

60A 

Enter eqn? press NEW 

60B 

Wane the equation? press ENTER 

60C 

Select plot type 

60D 

Empty catalog 

60F 

! No stat data to plot 

610 

Rutoscallng 

614 

Select a mode1 

619 

Acknowledged 

61A 

Enter alarm? press SET 1 

61B 

Select repeat interval 

61C 

I/O setup menu 

61D 

Plot types 

61E 

it it 

61F 

(OFF SCREEN) 

620 

Invalid PTYPE 1 

621 

Name the stat data? press ENTER 

622 

Enter value (zoom out if >1>? press 


ENTER 1 

623 

Copied to stack 

624 

x axis zoom wxAUTO. 

625 

x axis zoom- 

626 

y axis zoom- 

627 

x and y-axis zoom- 

A01 

0 ad Guess ( es .■* 

A02 

C o n s t a n t ? 

A03 

Interrupted 

A04 

Z e r o 

A05 

Sign Reversal 

A06 

Extremum i 
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Messages Listed Numerically (continued) 

Message 

_ Unit Management _ 

I rivalid Unit 

I neonsistent Unitg _ 

I/O and Printing 

Bad Packet Block check 
T i n e o u t 
Receive Error 
Receive Buffer Overrun 
P a r i t y E r r o r 
Transfer Fai1ed 
Prot oco1 Error 
1 n v a 1 i d S e r v e r C n d „ 

P ort Closed 
C o n n e c t i n g 
Retry # 

Rwaiting Server Cnd, 

Sending 

Receiving 

Object Discarded 

P a c k e t # 

Processing Connand 

Invalid 10P f IR 
Invalid PRTPflR 

L o w B a 11 e r y 
E pi p t y S t a c k 
Invalid Mane 
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Messages Listed Numerically (continued) 


# (hex) 

Message 

Time Messages 

D01 

Invalid Date 

D02 

Invalid Tine 

D03 

Invalid Repeat 

D04 

Nonexistent filarn 

Equation Library Messages 

E303 

K e y t.i.i ij r d U o n f 1 i c t 

E304 

No Picture fivai1ab1e 

1 -----—--- - --—--- 

Multiple-Equation Solver Messages 

1 E401 

I ri v a 1 i d M p a r 

E402 

Sing1e Equation 

E403 

EQ Invalid for MINIT 

E404 

T o o M a n y U n k n o w n s 

E405 

fill Variables Known 1 

E406 

Illegal During MROOT 

Miscellaneous Messages 

70000 

(user-defined message created with DOERR) 
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Table of Units 



HP 48 Units 


_ Unit (Full Name) 

a (are) 

A (ampere) 
acre (acre) 

arcmin (minute of arc) 
arcs (second of arc) 
atm (atmosphere) 
an (astronomical unit) 

A (Angstrom) 
b (barn) 
bar (bar) 
bbl (barrel) 

Bq (becquerel) 

Btu (international table Btu) 
bu (bushel) 

°C (degree Celsius) 
c (speed of light) 

C (coulomb) 
cal (calorie) 
cd (candela) 
chain (chain) 

Ci (curie) 
ct (carat) 
cn (US cup) 

0 (degree) 
d(day) 


Value in SI Units 

100 m 2 

1 A 

4046.87260987 m 2 
2.90888208666 X 10' 4 r 
4.8481368111 X 10“ 6 r 
101325 kg/rms 2 
1.495979 X 10 11 m 
1 x 10- 10 m 

1 x 10‘ 28 m 2 
100000 kg/m-s 2 

.158987294928 m 3 

1 1/s 

1055.05585262 kg*m 2 /s 2 
.03523907 m 3 
1 K or 274.15 K 
299792458 m/s 
1 A-s 

4.1868 kg-m 2 /s 2 

1 cd 

20.1168402337 m 
3.7 x 10 10 1/s 
.0002 kg 

2.365882365 X 10 -4 m 3 
1.74532925199 X 10 -2 r 
86400 s 
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HP 48 Units (continued) 


Unit (Full Name) 


Value in SI Units 


00001 kg-m/s 


dyn (dyne) 
erg (erg) 
eV (electron volt) 

F (farad) 

°F (degrees Fahrenheit) 

f ath (fathom) 
fbm (board foot) 
fc (footcandle) 

Fdy (faraday) 
fermi (fermi) 
flam (footlambert) 
ft (international foot) 
ftUS (survey foot) 
g (gram) 

ga (standard freefall) 
gal (IJS gall on) 
galC (Canadian gallon) 
galUK (UK gallon) 
gf (gram-force) 
grad (gradient) 
grain (grain) 

Gy (gray) 

H (henry) 
h (Hour) 
hp (horsepower) 

Hz (hertz) 
in (inch) 

inHg (inches of mercury, 0°C) 
inH20 (inches of water, 60°F) 
J (joule) 

K (kelvins) 
kg (kilogram) 


.0000001 kg*m 2 /s 2 

1.60217733 x 10“ 19 kg-m 2 / 

1 A 2 -s 4 /kg-m 2 

0.555555555556 K or 
255.927777778 K 

1.82880365761 m 
.002359737216 m 3 
10.7639104167 cd-sr/m 2 
96487 A*s 
1 X 10” 15 m 
3.42625909964 cd/m 2 
.3048 m 

.304800609601 m 

.001 kg 
9.80665 m/s 2 
.003785411784 m 3 
.00454609m 3 
.004546092 m 3 
.00980665 kg-m/s 2 
1,57079632679 x 10' 2 r 
.00006479891 kg 

1 m 2 /s 2 
1 kg-m 2 /A 2 -s 2 
3600 s 

745.699871582 kg-m 2 /s 3 
l/s 

.0254 m 

3386.38815789 kg/m-s 2 
248.84 kg/m-s 2 
1 kg*m 2 /s 2 

1 K 

1 kg 
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HP 48 Units (continued) 


Unit (Full Name) 
kip (kilopound-force) 
knot (nautical miles per hour) 
kph (kilometers per hour) 

1 (liter) 

lam (lambert) 

lb (avoirdupois pound) 

lbf (pound-force) 

lbt (troy pound) 

lm (lumen) 

lx (lux) 

lyr (light year) 

m (meter) 

.u (micron) 
mho (mho) 

mi (international mile) 

mil (mil) 

min (minute) 

miUS (US statute mile) 

mmfig (millimeter of mercury (torr), 

mol (mole) 

mph (miles per hour) 

H (newton) 

nm i (nautical mile) 

Q (ohm) 
oz (ounce) 

ozfl (US fluid ounce) 
ozt (troy ounce) 
ozUK (UK fluid ounce) 

P (poise) 

Pa (pascal) 
pc (parsec) 

pdl (poundal) 
ph (phot) 
pk (peck) 


Value in SI Units 

4448.22161526 kg-m/s 2 
.514444444444 m/s 
.277777777778 m/s 

.001 m 3 

3183.09886184 cd/m 2 
.45359237 kg 
4.44822161526 kg-m/s 2 
.3732417216 kg 

1 cd-sr 
1 cd-sr/m 2 

9.46052840488 X 10 16 m 

1 m 

1 X 10” 6 m 
1 A 2 *s 3 /kg-in 2 
1609.344 m 
.0000254 m 
60 s 

1609.34721869 m 
°C) 133,322368421 kg/m-s 2 

1 mol 

.44704 m/s 
1 kg-m/s 2 

1852 m 

1 kg-m 2 /A 2 *s 3 
.028349523125 kg 
2.95735295625 X 10“ 5 m 3 
.0311034768 kg 
2.8413075 X 10“ 6 m 3 

.1 kg/m-s 
1 kg/m-s 2 

3.08567818585 X 10 16 m 
.138254954376 kg-m/s 2 
10000 cd-sr/m 2 
.0088097675 m 3 


Table of Units B-3 



HP 48 Units (continued) 


Unit (Full Name) 

Value in SI Units 

psi (pounds per square inch) 

6894.75729317 kg/m-s 2 

pt (pint) 

.000473176473 m 3 

qt (quart) 

.000946352946 m 3 

r (radian) 

1 r 

R (roentgen) 

.000258 A-s/kg 

°R (degrees Rankine) 

0.555555555556 K 

rad (rad) 

,01 ni 2 /s 2 

rd (rod) 

5,02921005842 m 

rem (rem) 

.01 m 2 /s 2 

s (second) 

1 s 

S (siemens) 

1 A 2 *s 3 /kg*m 2 

sb (stilb) 

10000 cd/m 2 

slug (slug) 

14.5939029372 kg 

sr (steradian) 

1 sr 

st (stere) 

1 m 3 

St (stokes) 

.0001 m 2 /s 

Sv (sievert) 

1 tn 2 /s 2 

t (metric ton) 

1000 kg 

T (tesla) 

1 kg/A'S 2 

tbsp (tablespoon) 

1.47867647813 x 10“ 5 m 3 

therm (EEC therm) 

105506000 kg*m 2 /s 2 

ton (short ton) 

907.18474 kg 

tonUK (long ton (UK)) 

1016.0469088 kg 

torr (torr (imnHg)) 

133.322368421 kg/m-s 2 

tsp (teaspoon) 

4.92892159375 x 10~ 6 m 3 

u (unified atomic mass) 

1.6605402 X 10 -27 kg 

V (volt) 

1 kg*m 2 /A-s 3 

W (watt) 

1 kg*m 2 /s 3 

tfb (weber) 

1 kg-m 2 /A-s 2 

yd (international yard) 

.9144 m 

yr (year) 

31556925.9747 s 
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System Flags 

This appendix lists the HP 48 system flags. You can set, clear, and 
test all flags. The default state of the flags is clear —except for the 
Binary Integer Wordsize flags (flags —5 through —10). 


System Flags 


Flag 

Description 

-1 

■ 

Principal Solution. 

Clear : QUAD and ISOL return a result representing all 
possible solutions. 

Set : QUAD and ISOL return only the principal solution. 

-2 

Symbolic Constants. 

Clear: Symbolic constants (e, i, 7r, MAXR, and MINE) 
retain their symbolic form when evaluated, unless the 
Numerical Results flag —3 is set. 

Set : Symbolic constants evaluate to numbers, regardless of 
the state of the Numerical Results flag —3. 

-3 

Numerical Results. 

Clear : Functions with symbolic arguments, including 
symbolic constants, evaluate to symbolic results. 

Set : Functions with symbolic arguments, including symbolic 
constants, evaluate to numbers. 

-4 

Not used. 

i 

-5 

thru 

-10 

Binary Integer Wordsize. 

Combined states of flags —5 through —10 set the wordsize 
from 1 to 64 bits. i 
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System Flags (continued) 


Flag 

Description i 

-11 

and 

-12 

Binary Integer Base. 

HEX: —11 set , —12 set. DEC: “11 clear , —12 c/ear. 

OCT: —11 sef, —12 c/ear, BIN: —11 clear , —12 seC 

-13 

Not used. 

-14 

Financial Payment Mode. 

Clear: TVM calculations assume end-of-period payments. 

Set* TVM calculations assume beginning-of-period payments. 

-15 

and 

-16 

Rectangular: —16 clear , 

Polar/Cylindrical: —15 c/ear, —16 set 

Polar/Spherical: —15 seC —16 set. 

-17 

and 

-18 

Degrees: —17 clear , —18 c/ear. 

Radians: —17 set 

Grads: —17 c/ear, —18 set 

-19 

Clear:— >V2 and creates a 2-dimensional vector from 2 real 
numbers. 

Set:— »V2 and creates a complex number from 2 real numbers. 

-20 

Underflow Exception, 

Clear: Underflow exception returns 0, sets flag —23 or —24. 
Set: Underflow exception treated as an error. 

-21 

Overflow Exception. 

Clear: Overflow exception returns ±9.99999999999E499 and 

sets flag —25. 

Set: Overflow exception treated as an error. 

-22 

Infinite Result Exception. 

Clear: Infinite result exception treated as an error. 

Set: Infinite result exception returns -H9.99999999999E499 

and sets flag —26. 

-23 

-24 

-25 

-26 

Negative Underflow Indicator, 

Positive Underflow Indicator. 

Overflow Indicator. 

Infinite Result Indicator. 

When an exception occurs, corresponding flag (—23 through 
—26) is set only if the exception is not treated as an error. 


* 
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System Flags (continued) 

Flag Description 

—27 Display of symbolic complex numbers. 

Clear : Displays symbolic complex numbers in coordinate 
form (i.e. 1 <x ? y> 1 ). 

Set: Displays symbolic complex numbers using 1 i 1 (i.e. 

1 x+y*i 1 ). 

—28 Simultaneous Plotting of Multiple Functions. 

Clear : Multiple equations are plotted serially. 

Set: Multiple equations are plotted simultaneously. 

—29 i Draw Axes. 

Clear: Axes are drawn for two-dimensional and statistical 
plots. 

, Set: Axes are not drawn for two-dimensional and statistical 
plots. 

■ ' I ^ 

—30 Not used. _ 

—31 Curve Filling. 

Clear: Curve filling between plotted points enabled. 

Set: Curve filling between plotted points suppressed. 

—32 ' Graphics Cursor. 

Clear: Graphics cursor always dark. 

Set: Graphics cursor dark on light background and light on 
dark background. 

—33 I/O Device. 

Clear: I/O directed to serial port. 

Set: I/O directed to IR port. 

—34 Printing Device. 

Clear: Printer output directed to IR printer. 

Set: Printer output directed to serial port if flag —33 is clear. 

I ■ ■ ^ n— m _ ——= ^M 

—35 I/O Data Format. 

Clear: Objects transmitted in ASCII form. 

Set: Objects transmitted in binary (memory image) form. 
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System Flags (continued) 


Flag Description 

—36 I/O Receive Overwrite. 

Clear : If file name received by HP 48 matches existing 
HP 48 variable name, new variable name with number 
I extension is created to prevent overwrite. 

i Set: If file name received by HP 48 matches existing HP 48 
variable name, existing variable is overwritten. 

—37 Double-Spaced Printing. 

Clear : Single-spaced printing. 

Set: Double-spaced printing. 

—38 Line Feed. 

Clear: Linefeed added at end of each print line. 

Set: No linefeed added at end of each print line. 

—39 ! I/O Messages. 

Clear: I/O messages displayed. 

Set: I/O messages suppressed. 

—40 Clock Display. 

Clear: Clock displayed only when TIME menu selected. 

Set: Ticking clock displayed at all times. 

- ^ - ■ ■ . . .— 

—41 Clock Format. 

Clear: 12-hour clock. 

_ Set: 24-hour clock. _ 

—42 Date Format. 

Clear: MM/DD/YY (month/day/year) format. 

Set: DD.MM.YY (day.month.year) format. 

—43 Repeat Alarms Not Rescheduled. 

Clear: Unacknowledged repeat appointment alarms 
automatically rescheduled. 

Set: Unacknowledged repeat appointment alarms not 
rescheduled. 

—44 Acknowledged Alarms Saved. 

Clear: Acknowledged appointment alarms deleted from 
alarm list. 

Set: Acknowledged appointment alarms saved in alarm list. 
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System Flags (continued) 


Flag 

Description 

-45 

thru 

-48 

Number of Decimal Digits. 

Combined states of flags —45 through —48 sets number of 
decimal digits in Fix, Scientific, and Engineering modes. 

-49 

and 

-50 

Number Display Format. 

Standard: —49 clear , —50 clear . 

Fix: —49 set, —50 clear. 

Scientific: —49 clear. —50 set. 

Engineering: —49 set ) —50 set. 

-51 

Fraction Mark. 

Clear : Fraction mark is . (period). 

Set: Fraction mark is , (comma). 

: -52 

Single-Line Display. 

Clear : Display gives preference to object in level 1, using up 
to four lines of stack display. 

Set: Display of object in level 1 restricted to one line. 

-53 

Precedence. 

Clear: Certain parentheses in algebraic expressions 
suppressed to improve legibility. 

Set : All parentheses in algebraic expressions displayed. 

-54 

Tiny Array Elements. 

Clear : Singular values computed by RANK (and other 
commands that compute the rank of a matrix) that are more 
than 1 x 10~ 14 times smaller than the largest computed 
singular value in the matrix are converted to zero. 

Automatic rounding for DET is enabled. 

Set: Small computed singular values (see above) not 
converted. Automatic rounding for DET is disabled. 

-55 

Last Arguments. 

Clear : Command arguments saved. 

Set : Command arguments not saved. 

—56 

Error Beep. 

Clear: Error and BEEP-command beeps enabled. 

Set: Error and BEEP-command beeps suppressed. 
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System Flags (continued) 


Flag 

Description 

-57 

Alarm Beep. 

Clear : Alarm beep enabled. 

Set : Alarm beep suppressed. 

-58 

Verbose Messages. 

Clear : Parameter variable data automatically displayed. 

Set: Automatic display of parameter variable data is 
suppressed. 

-59 

Fast Browser Display. 

Clear: Variable Browser shows variable names and contents. 
Set : Variable Browser shows variable names only. 

-60 

Alpha Lock. 

Clear: Single-Alpha activated by pressing (a) once. Alpha 
lock activated by pressing (a) twice. 

Set: Alpha lock activated by pressing (a) once. (Single-Alpha 
not available.) i 

-61 

User-Mode Lock. 

Clear: 1-User mode activated by pressing (*t)(USER) once. 
User mode activated by pressing f^rlfUSER) twice. 

Set: User mode activated by pressing (iilfuSER) once. 

(1-LTser mode not available.) 

-62 

User Mode. 

Clear: User mode not active. 

Set: User mode active. 

! —63 

Vectored (ENTER). , 

Clear: (ENTER) evaluates command line. 

Set: User-defined (ENTER) activated. 

' -64 

Index Wrap Indicator, 

Clear: Last execution of GETI or PUT! did not increment 
index to first element. 

Set : Last execution of GETI or PUTI did increment index to , 
first element. 
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Reserved Variables 


The HP 48 uses the following reserved variables. These have specific 
purposes, and their names are used as implicit arguments for certain 
commands. Avoid using these variables’ names for other purposes, or 
you may interfere with the execution of the commands that use these 
variables. 

You can change some of the values in these variables with 
programmable commands, while others require you to store new values 
into the appropriate place. 


Reserved 

Variable 

What It Contains 

Used By 

ALRMDAT 

Alarm parameters. 

TIME ALRM operations 

CST 

List defining the CST 
(custom) menu. 

MENU, (CST) 

"der” -names 

User-defined derivative. 

d 

EQ 

Current equation. 

ROOT, DRAW 

EX PR 

Current expression. 

SYMBOLIC 

10 PA R 

I/O parameters. : 

I/O commands 

MEpar 

Minehunt game status. 

MINEHUNT 

Mpar 

Multiple-Equation Solver 
equations. 

EQ LIB 

nl f nS f ... 

Arbitrary integers. 

ISOL, QUAD 

Nmines 

Minehunt game data. 

MINEHUNT 
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Reserved 

Variable 

What It Contains 

Used By 

PPAR 

Plotting parameters. 

DRAW 

PRTPAR 

Printing parameters. 

PRINT commands 

si, s2, ... 

Arbitrary signs. 

ISOL, QUAD 

VPAR | 

Viewing parameters. 

DRAW 

ZPAR 

Plot zoom factors. 

DRAW 

S DA T 

Statistical data. 

Statistics application, 

DRAW 

SPAR 

Statistical parameters. 

Statistics application, 
DRAW 


Contents of the Reserved Variables 

Most reserved variables (except ALRMDAT , IOPAR and PRTPAR) 
can be stored with different contents in different directories. This 
allows you, for example, to save several sets of statistical data in 
different directories. 

ALRMDAT 

ALRMDAT does not reside in a particular directory. You cannot 
access the variable itself, but you can access its data from any 
directory using the RCL ALARM and S TO ALARM commands, or 
through the Alarm Catalog. 

ALRMDAT contains a list of these alarm parameters: 
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Parameter 

(Command) 


date (—►DATE) 


time (-►TIME) 


action 


repeat 


Description 


Default 

Value 


A real number specifying the date of Current 


the alarm: MM.DDYYYY (or 
DDMMYYYY if flag -42 is set). If 
YYYY is not included, the current 
year is used. 

A real number specifying the time of I 00.0000 
the alarm: HH.MMSS . 

A string or object: 


date. 


■ a string creates an appointment 
alarm , which beeps and displays 
the string 

■ any other object creates a control 
alarm , which executes the object i 

A real number specifying the interval 0 
between automatic recurrences of the 
alarm, given in ticks (a tick is 1 /si92 
of a second). 


Empty 

string 

(appoint¬ 

ment 

alarm). 


Parameters without commands can be modified with a program by 
storing new values in the list contained in ALRMDAT (use the PUT 
command). 


CST 

CST contains a list (or a name specifying a list) of the objects that 
define the CST ( custom ) menu. Objects in the custom menu behave 
as do objects in built-in menus. For example: 

■ Names behave like the VAR menu keys. Thus, if ABC is a variable 
name, tlffllgp? evaluates ABC , fr* 1 IH Sjjj l recalls its contents, and 
If Iff 111- stores new contents in ABC, 

L ■ a - l I I i i I fa fa 1 I I ■ I I I ... .i. Jiiiii 


The menu label for the name of a directory has a bar over the left 
side of the label; pressing the menu key switches to that directory. 

Unit objects act like unit catalog entries (and have left-shifted 
conversion capabilities, for example). 
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■ String keys echo the string. 

■ You can include backup objects in the list defining a custom menu 
by tagging the name of the backup object with its port location (0 

through 33). 

You can specify menu labels and key actions independently by 
replacing a single object within the custom-menu list with a list of the 
form l " label-object" action-object >. (See “Customizing Menus” and 
“Enhancing Custom Menus” in chapter 30 of the HP 48 User’s Guide 
for more information.) 

To provide different shifted actions for custom menu keys, 
action-object can be a list containing three action objects in this order 

■ The unshifted action (required if you want to specify the shifted 

actions). 

■ The left-shifted action. 

■ The right-shifted action. 

See “Enhancing Custom Menus” in chapter 30 of the HP 48 User’s 
Guide . 

“der-” Names 

If d is applied to a function for which there is no built-in derivative, it 
returns a new function whose name is “der” followed by the original 
function name. These “der”-function names are reserved variable 
names. 

For an example, refer to “Creating User-Defined Derivatives” in 
chapter 20 of the HP 48 User’s Guide. 

EQ 

EQ contains the current equation or the name of the variable 
containing the current equation. 

EQ supplies the equation for ROOT, as well as for the plotting 
command DRAW when the plot type is FUNCTION, CONIC, 
POLAR, PARAMETER, TRUTH, or DIFFEQ. (EDAT supplies 
the information when the plot type is HISTOGRAM, BAR, or 
SCATTER.) 
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The object in EQ can be an algebraic object, a number, a name, or a 

program. How DRAW interprets EQ depends on the plot type. 

For graphics use, EQ can also be a list of equations or other objects. 
If EQ contains a list, then DRAW treats each object in turn as the 
current equation, and plots them successively. However, ROOT in the 
HP Solve application cannot solve an EQ containing a list . 

To alter the contents of EQ, use the command S I EQ. 

EXPR 

EXPR contains the current algebraic expression (or the name of the 
variable containing the current expression) used by the SYMBOLIC 
application and its associated commands. The object in EQ must be 
an algebraic or a name. 


IOPAR 

10PAR is a variable in the HOME directory that contains a list of the 
I/O parameters needed for a communications link with a computer. 

It is created the first time you transfer data or open the serial port 
(OPENIO), and is automatically updated whenever you change the 
I/O settings. All IOPAR parameters are integers. 


Parameter 

(Command) 

Description 

Default 1 
Value 

baud (BAUD) 

parity (PARITY) 

The baud rate: 1200, 2400, 4800, or 
9600. 

The parity used: O^none, 1—odd, 
2^=even, 3— mark, 4=space. The value 
can be positive or negative: a positive 
parity is used upon both transmit and 
receive; a negative parity is used only 
upon transmit. 

9600 ' 

0 
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Parameter 

(Command) 

Description l 

Default 

Value 

receive pacing 

Controls whether receive pacing is 

0 (no 


used: a nonzero real value enables 
pacing, while zero disables it. Receive 
pacing sends an XOFF signal when the 
receive buffer is almost full, and sends 
an XON signal when it can take more 
data again. Pacing is not used for 
Kermit I/O, but is used for other 
serial I/O transfers. 

pacing) 

transmit pacing 

Controls whether transmit pacing is 

0 (no 


used: a nonzero real value enables 
pacing, while zero disables it. 

Transmit pacing stops transmission 
upon receipt of XOFF, and resumes 
transmission upon receipt of XON. 
Pacing is not used for Kermit I/O, but 
is used for other serial I/O transfers. 

pacing) 

checksum 

Error-detection scheme requested 

3 

(CKSM) 

when initiating SEND: 

■ 1=1-digit arithmetic checksum 

■ 2=2-digit arithmetic checksum 

■ 3=3-digit cyclic redundancy check. 


translation code 

Controls which characters are 

1 

(TRANSIO) 

translated: 

■ 0=none 

■ 1=translate character 10 (line feed 
only) t.o/from characters 10 and 13 
(line feed and carriage return) 

■ 2=translate characters with numbers 

128 through 159 (80-9F hex) 

■ 3=translate characters with 
numbers 128 through 255. 



Parameters without commands can be modified with a program 
by storing new values in the list contained in IOPAR (use the PUT 
command), or by editing IOPAR directly. 
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MHpar 

MHpar stores the status of an interrupted Minehunt game. MHpar is 
created when you exit Minehunt by pressing (STO) . If MHpar still 
exists when you restart Minehunt, the interrupted game resumes and 
MHpar is purged. 


Mpar 

Mpar is created when you use the Equation Library’s 

Multiple-Equation Solver, and it stores the set of equations you’re 

using. 


When the Equation Library starts the Multiple-Equation Solver, it 
first stores a list of the equation set in EQ, and stores the equation 
set, a list of variables, and additional information in Mpar, Mpar is 
then used to set up the Solver menu for the current equation set. 


Mpar is structured as library data dedicated to the Multiple Equation 
Solver application. This means that although you can view and edit 
Mpar directly, you can edit it only indirectly by executing commands 
that modify it. 


You can also use the MINIT command ( f^-pfEQ LIB] l llliii iBHSBI) 

.. . ./ 

to create MHpar from a set of equations on the stack. See “Defining a 
Set of Equations ’ in chapter 25 of the HP 48 User’s Guide. 


nl, n2, ... 

The ISOL and QUAD commands return general solutions (as opposed 
to principal solutions) for operations. A general solution contains 
variables for arbitrary integers or arbitrary signs, or both. 

The variable nl represents an arbitrary integer 0, ±1, ±2, etc. 
Additional arbitrary integers are represented by n2, n3 } etc. 

If flag —1 is set, then ISOL and QUAD return principal solutions, in 
which case the arbitrary integer is always zero. 
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Nmines 


Nmines is a variable you create in the current directory to control 
the number of mines used in the Minehunt game. Nmines contains 
an integer in the range 1 to 64; if Nmines is negative, the mines are 
visible during the game. 

PPAR 

PPAR is a variable in the current directory. It contains a list 
of plotting parameters used by the DRAW command for all 
mathematical and statistical plots, by AUTO for autoscaling,, and by 
the interactive (nonprogrammable) graphics operations. 

Description 

A complex number specifying the 
lower left corner of PICT (the lower 
left corner of the display range). 

A complex number specifying the 

upper right corner of PICT (the 
upper right corner of the display 
range). 

A name specifying the independent 
variable, or a list containing that 
name and two numbers that specify 
the minimum and maximum values 
for the independent variable (the 

plotting range). 


Default 

Value 

(-6.50, -3.1) 
(6.5, 3.2) 


X 



ame 



(Command) 


(^min j^min) 

(XRNG, 
YEN G) 

O^rnax5 2/max) 

(XRNG, 

YRNG) 


indep 

(INDEP) 
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Parameter 

(Command) 

Description 

Default 

Value 

res 

Resolution. A real number specifying 

0 

(RES) 

the interval between values of the 
independent variable. For plots of 
equations, this determines the 
plotting interval along the £-axis. A 
binary number specifies the pixel 
resolution (how many columns of 
pixels between points). An integer 
specifies the resolution in user units 
(how many user units between 
points). Resolution for statistical 
plots is different (see below). 


axes 

A complex number specifying the 

(0, 0) 

(AXES) 

user-unit coordinates of the plot 
origin, or a list containing the 
following: 

■ the complex number specifying the 
origin 

■ a real number, binary integer, or 
list containing two real numbers or 
binary integers specifying the 
tick-mark annotation (see ATICK) 

■ two strings specifying labels for 
the horizontal and vertical axes 


ptype 

A command name specifying the plot 

FUNCTION 

(BAR, etc.) 

type (BAR, CONIC, DIFFEQ, 
FUNCTION, GRIDMAP, 
HISTOGRAM, PARAMETRIC, 
PARSURFACE, PCONTOUR, 
POLAR, SCATTER, SLOPEFIELD, 
TRUTH, WIREFRAME, or 

YSLICE). 
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Parameter 
(Command) 

Description 

Default 

Value 

depend 

(DEPND) 

A name specifying the dependent 
variable, or a list containing the 
name and two numbers that specify 
vertical plotting range. For 

DIFFEQ, the second element of the 
list may also be a real vector that 
represents the initial value. 

Y 


Parameters without commands can be modified with a program 
by storing new values in the list contained in PPAR (use the PUT 
command) * 


The 1111* operation (f^l fPLOTl lljliai Hill) resets the PPAR 
parameters (except ptype) to their default values, and erases PICT. 


Noic that 1 behaves differently for the statistical plot types BAR, 
HISTOGRAM, and SCATTER than for other plot types. For BAR, 
res specifies bar width; for HISTOGRAM, res specifies bin width; res 


does not affect SCATTER. 
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PRTPAR 

PRTPAR is a variable in the HOME directory that contains a list of 
printing parameters. It is created automatically the first time you use 
a printing command. 


Parameter 

(Command) 

Description 

Default 

Value 

delay time 

A real number, in the range 0 to 

1.8 

(DELAY) 

6.9, specifying the number of 
seconds the HP 48 waits between 
sending lines. This should be at 
least as long as the time required to 
print the longest line. If the delay 
is too short for the printer, you will 
lose data. The delay setting also 
affects serial printing if 
transmit-pacing (in IOPAR ) is not 
being used. 


remap 

A string defining the current 

Empty 

(OLDPRT stores 

remapping of the extended 

string. 

the character- 

character set for printing. The 


remapping string 

string can contain as many 


for the HP 

characters as you want to remap, 


82240A Infrared 

with the first character being the 


Printer) 

new character 128, the second being 
the new charcter 129, etc. (Any 
character number that exceeds the 
string length will not be 
remapped.) See the example below. 


line length 

A real number specifying the 
number of characters in a line for 
serial printing. This does not affect 
infrared printing. 

80 

line termination 

A string specifying the 

Control 


line-termination method for serial 

characters 13 


printing. This does not affect 

(carriage 


infrared printing. 

return) and 

10 (line 
feed). 
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Parameters without commands can be modified with a program by 
storing new values in the list contained in PRTPAR (use the PUT 

command). 

A change in a parameter is effective immediately, except when printing 
the display using the simultaneous keystrokes (ON If I/Q 1 (because this 
does not use PRTPAR ). This printing method is affected only by the 
delay parameter, a change in which will not affect (ON lfl/Ol until after 
the next printing command has been executed. To use a new delay 
time with fON Ifl/Ql immediately, use the DELAY command. 

Example: If the remapping string were “ABCDEFGH” and the 
character to be printed had value 131, then the character actually 
printed would be “D”, since 131 — 128=3 and “A” has the value zero. 

A character code of 136 or greater would not be remapped since 
136—128=8, which exceeds the length of the string. 

si, s2, ... 

The ISOL and QUAD commands return general solutions (as opposed 
to principal solutions) for operations. A general solution contains 
variables for arbitrary integers or arbitrary signs or both. 

The variable si represents an arbitrary + or — sign. Additional 
arbitrary signs are represented by s2 : s3. etc. 

If flag —1 is set, then ISOL and QUAD return principal solutions, in 
which case the arbitrary sign is always +1. 
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VP A R is a variable in the current directory. It contains a list of 
parameters used by the 3D plot types. The main data structure stored 
in VPAR describes the “view volume." the abstract three-dimensional 
region in which the function is plotted. 


Parameter 

(Command) 

Description 

Default 

Value 

(^ieft > bright) 

(XVOL) 

Real numbers that specify the width 
of the view volume. 

(- 1 . i) 

(^far) J/near) 

(YVOL) 

Real numbers that specify the depth 
of the view volume. 

l-i, i) 

(^lowj "high) 

(ZVOL) 

Real numbers that specify the height 
of the view volume. 

(-i, i) 

( ■£ eye , 2/eye, ^eye) 

(EYEPT) 

Real numbers that specify the point 
in space from which the plot is 
viewed. 

(0, —3, 0) 

(■^step, V step) 

(NUMX,NUMY) 

Real numbers that specify the 
increments between of x-coordinates 
and y-coordinates plotted. The 
increments are equal to the range for 
the axes divided by the number of 
steps. Used instead of (or in 
combination with) res. 

(10, 8) 

( ^left, ^2-right) 

(XXRNG) 

Real numbers that specify the width 
of the input plane (domain). Used 

by GRIDMAP and PARSURFACE. 

(-1, 1) 

(y^farj yVne ar) 

(YYRNG) 

Real numbers that specify the depth 
of the input plane (domain). Used 
by GRIDMAP and PARSURFACE. 

(-1, 1) 


Parameters without commands can be modified programmatically 
by storing new values in the list contained in VPAR (use the PUT 
command). 


The llllf! operation ( f+iHPLOTl fNXT 1 |gi|||| flOHi fNXTl 


resets the VPAR parameters to their default values. 
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ZPAR 


ZPAR is a variable in the current directory. It contains a list of 
zooming parameters used by the DRAW command for all 2-D 
mathematical and statistical plots. 


Parameter Description Default 

(Command) Value 


h-factor Real number that specifies the 4 

horizontal zoom factor. 

v-factor Real number that specifies the 4 

vertical zoom factor. 

recenter flag 0 or 1 depending on whether the 0 

recenter at crosshairs option was 


selected in the set zoom factors input 
form. 

{ hst } An empty list, or a copy of the last 

PPAR. 


Use the set zoom factors input form (SSlUil) to modify ZPAR. 


* 
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I DAT 


SDAT is a variable in the current directory that contains either the 
current statistical matrix or the name of the variable containing 
this matrix. This matrix contains the data used by the Statistics 
applications. 


Statistical Matrix for Variables 1 to m 


var i 

var 2 ... 

var m 

x n 

^21 • * * 

*^ml 

% 12 

* 

l * 

X 22 

• * 

• * 

*- 

* * 

* 

X\ n 

* ■■ 

$2n * * * 

< 

^mn 


You can designate a new current statistical matrix by entering new 
data, editing the current data, or selecting another matrix. 

The command CLE clears the current statistical matrix. 
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I PAR 


SPAR is a variable in the current directory that contains either 
the current statistical parameter list or the name of the variable 
containing this list. 


Parameter 

(Command) 

Description 

Default 

Value 

ColuTTMindep 

(XCOL) 

A real number specifying the 
independent-variable’s column 
number. 

i n 

column 

(YCOL) 

A real number specifying the 
dependent-variable’s column number. 

2 

intercept 

(LR) 

A real number specifying the 
coefficient of intercept as determined 
by the current regression. 

0 

slope 

(LR) 

A real number specifying the 
coefficient of slope as determined by 
the current regression. 

0 

model 

(LINFIT, etc.) 

A command specifying the regression 
model (LINFIT, EXPFIT, 

PWRFIT, or LOGFIT). 

LINFIT 
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New Commands 


In the following tables, new commands (commands that were not 
available on a standard HP 48S series calculator) are arranged 
alphabetically and followed by brief descriptions* All of these 
commands are described in chapter 3. 


New Commands Listed Alphabetically 


Command 

Brief Description 

ADD 

1 Adds list elements. 

AMORT 

Amortizes a loan or investment based upon the 
current amortization settings. 

ANIMATE 

Displays graphic objects in sequence. 

ATICK 

Sets the axes tick-mark annotation in the reserved 
variable PPAR . 

CHOOSE 

Creates a user-defined choose box. 

CLTEACH , 

Removes the EXAMPLES subdirectory and its 
contents from the HOME directory. 

COL+ 

Inserts an array (vector or matrix) into a matrix. 

COL- 

Deletes a column from of a matrix. 

COL—* 

Transforms a series of column vectors and a column 
count into a matrix, or transforms a sequence of 
numbers and an element count into a vector. 

^COL 

Transforms a matrix into a series of column vectors, 
or transforms a vector into its elements. 
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New Commands Listed Alphabetically (continued) 


Command 

Brief Description 

COND 

Returns the 1-norrn (column norm) condition 
number of a square matrix. 

CONLIB 

Opens the Constants Library catalog. 

CONST 

Returns the value of a constant. 

CSWP 

Swaps columns in a matrix. 

CYLIN 

Sets Cylindrical coordinate mode. 

DARCY 

Calculates the Darcy friction factor of certain fluid 
flows. 

DIAG-* 

Takes an array and a specified dimension and 
returns a matrix whose main diagonal elements are 
the elements of the array. 

—vDIAG 

Returns a vector that contains the major diagonal 
elements of a matrix. 

DIFFEQ 

Specifies differential equations as the plot type. 

DOLIST 

Applies commands, programs, or user-defined 
functions to lists. 

DOSUBS 

Applies a program or command to groups of 
elements in a list. 

EGV 

Computes the eigenvalues and right eigenvectors for 
a square matrix. 

EGVL 

Computes the eigenvalues of a square matrix. 

ENDSUB 

Provides a way to access the total number of 
sublists used while executing a program or j 

command using DOSUBS. 

EQNLIB 

Starts the Equation Library application. 

EYEPT 

Specifies the coordinates of the eye point in a 
perspective plot. 
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New Commands Listed Alphabetically (continued) 


Command 

Brief Description 

FOA 

Returns the fraction of total black-body emissive 
power. 

FANNING 

Calculates the Fanning friction factor of certain 
fluid flows. 

FFT 

Computes the one- or two-dimensional discrete 1 

Fourier transform of an array. 

FR.EE1 

Frees the previously merged RAM in port L 

GRIDMAP 

Specifies grid mapping as the plot type. 

i HEAD 

Returns the first element of a list or string. 

IFFT 

Computes the one- or two-dimensional inverse 
discrete Fourier transform of a vector or matrix. 

INFORM 

Creates a user-defined dialog box (Input Form). 

LIBEVAL 

Evaluates unnamed library objects by their 
memory addresses. 

LININ 

Tests whether an algebraic is structurally linear for 
a given variable. 

ELIST 

Returns the sum of the elements in a list. 

nLIST 

Returns the product of the elements in a list. 

ALIST 

Returns the set of first differences. 

LQ 

Returns the LQ factorization of an nxm matrix. 

LSQ 

Returns the minimum norm least squares solution 
to any system of linear equations. 

LU 

Returns the LU decomposition of a square matrix. 

MCALC 

Designates a variable as a calculated value (not 
user-defined). i 

MERGE 1 

Merges the RAM from the card in port 1 with the 
rest of main user memory. 


New Commands E-3 






New Commands Listed Alphabetically (continued) 


Command 

Brief Description 

MINEHUNT 

Starts the MINEHUNT game. 

MINIT 

Creates the reserved variable Mpar. , 

MITM 

Changes multiple equation menu titles and order. 

MROOT 

Solves for one or more variables. 

MSGBOX 

Creates a user-defined message box. 

MSOLVR 

Gets the Multiple-Equation Solver variable menu 
for the set of equations defined by Mpar . 

MUSER 

Designates a variable as user-defined. 

NDIST , 

Returns the normal probability distribution. 

NOVAL 

Place holder for reset and initial values in 
user-defined dialog boxes. 

NSUB 

Provides a way to access the current sublist number 
during an iteration of a program or command 

applied using DO SUBS. 

NUMX 

Sets the number of x-steps for each y-step in 3D 
perspective plots. 

NUMY 

Sets the number of y-steps across the view volume 
in 3D perspective plots. 

PARSURFACE 

Specifies 3D parameterized surface grip mapping as 
the plot type. 

PCOEF 

Returns the coefficients of a monic polynomial. 

PCOV 

Calculates population covariance. 

PCONTOUR 

Specifies pseudo-contour as the plot type. 

PEVAL 

Evaluates an n-degree polynomial at x. 

PINIT 

Initializes the plug-in card ports. 

PROOT 

Returns all roots of an n-degree polynomial having 
real or complex coefficients. 
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New Commands Listed Alphabetically (continued) 


Command 

Brief Description 

PSDEV 

Calculates population standard deviation. 

PVAR 

Calculates population variance. 

QR 

Returns the QR factorization of an nxm matrix. 

RANK 

Returns the rank of a rectangular matrix. 

RANM 

Returns a matrix of random integers. 

RCI 

Multiplies a row of a matrix by a constant. 

RCIJ 

Multiplies a row v of a matrix by a constant, and 
then adds the product to another row of the matrix. 

RECT 

Sets Rectangular coordinate mode. 

REVLIST 

Reverses the order of the elements in a list. 

RKF 

Computes the solution to an initial value problem 
for a differential equation, using the 

Runge-Ku11a-Fehlberg method. 

RKFERR 

Returns the absolute error estimate for a given step 
when solving an initial value problem for a 
deferential equation (using RKF method). 

RKFSTEP 

Computes the next solution step to an initial value 
problem for a differential equation. 

ROW+ 

Inserts an array into a matrix. 

ROW- 

Deletes a row from a matrix. 

RREF 

Converts a rectangular matrix to reduced row 
echelon form. 

RRK 

Computes the solution to an initial value problem 
for a differential equation with known partial 
derivatives. 

RRKSTEP 

Computes the next solution step to an initial value 
problem for a differential equation, and displays the 
method used to arrive at that result. 

_i 
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New Commands Listed Alphabetically (continued) 


Command 

Brief Description 

RSBERR 

Returns an error estimate for a given step when 
solving an initial values problem for a differential 
equation (using the Rosenbrock method). 

RSWP 

Swaps rows in a matrix. 

SCHUR 

Returns the Schur decomposition of a square 
matrix. 

SEQ 

Returns a list of results generated by repeatedly 
executing an object on a specified range of 
elements. 

SIDENS 

Calculates the intrinsic density of silicon as a 
function of temperature. 

SLOPEFIELD 

Specifies slopefield as the plot type. 

SNRM 

Returns the spectral norm of an array. 

SOLYEQN 

Starts the solver for a specified set of equations. 

SORT 

Sorts the elements in a list in ascending order. 

SPHERE 

Sets Spherical coordinate mode. 

SRAD 

Returns the spectral radius of a square matrix. 

STREAM 

Applies an object to every element in a list. 

SVD 

Returns the singular value decomposition of an 
nxm matrix. 

SVL 

Returns the singular values of an m x n matrix. 

TAIL 

Returns all but the first element of a list or string. 

TDELTA 

Calculates a temperature change. 

TEACH 

Creates an EXAMPLES subdirectory in the HOME 
directory and loads HP 48 programming, graphing, 
and solver examples from ROM into it. 

TING 

Calculates a temperature increment. 

TRACE 

Returns the trace of a square matrix. 
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New Commands Listed Alphabetically (continued) 


Command 

Brief Description 

TVM 

Start the TVM solver. 

TVMBEG 

Specifies that payments are made at the beginning , 
of compounding periods. 

TVMEND 

Specifies that payments are made at the end of 
compounding periods. 

TVMROOT 

Solves for the specified TVM variable using values 

from the remaining TVM variables. 

VERSION 

Returns the software version and copyright 
message. 

WIREFRAME 

Specifies wireframe as the plot type. 

XRECV 

Receives an object via XModem. 

XSEND 

Sends an object via XModem. 

XVOL 

Sets the width of the view volume in the reserved 
variable VPAR, 

XXRNG 

Specifies the x range of an input plane (domain) for 

GRIDMAP and PARSURFACE plots. 

YSLICE 

Specifies y-slice cross sections as the plot type. 

YVOL 

Sets the depth of the view volume in the reserved 
variable VPAR. 

YYRNG 

Specifies the y range of an input plane (domain) for 
GRIDMAP and PARSURFACE plots. 

Z FACTOR ; 

Calculates the the gas compressibility correction 
factor for nonideal behavior of a hydrocarbon gas. 

ZVOL 

Sets the height of the view volume in the reserved 
variable VPAR . 
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Technical Reference 


This appendix contains the following information: 

■ Object sizes. 

■ Mathematical simplification rules used by the HP 48. 

■ Symbolic differentiation patterns used by the HP 48. 

■ The Equation Writer ; s expansion rules. 

■ References used as sources for constants and equations in the HP 48 
(other than those in the Equation Library). 
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Object Sizes 

The following table lists object types and their size in bytes. (Note 
that characters in names, strings, and tags use 1 byte each.) 


Object Size 


Object Type 

Size (bytes) 

Algebraic 

5 + size of included objects 

Backup Object 

12 + number of name characters + size 
of included object 

Binary Integer 

13 

Command 

2.5 

Complex matrix 

15 + 16 x number of elements 

Complex number 

18.5 

Complex vector 

12.5 + 16 x number of elements 

Directory 

6.5 + size of included variables 

Graphics Object 

10 + number of rows x 

CEIL(columns/8) 

List 

5 + size of included objects 

! Matrix 

15 + 8 x number of elements 

Program 

12.5 + size of included objects 

Quoted global or local 

8.5 + number of characters 

1 name 

Real number 

10.5 

String 

5 + number of characters 

Tagged Object 

3.5 + number of tag characters + size of 
untagged object 

Unit Object 

7.5 + 

real magnitude 

2.5 or 10.5 

each prefix 

6 

each unit name 

5 + number of characters 

each x,", or / 

2.5 

each exponent 

2.5 or 10.5 

Unquoted global or local 

3,5 + number of characters 

name 

Vector 

12.5 + 8 x number of elements 

XLIB name 

5.5 
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Automatic Simplification Rules 

The following tables list the automatic simplification rules for the 

HP 48. 

Addition and Subtraction 


Object 

Simplified 

£ + (0,0) 

X 

x-\ — p 

£-p 

x — 0 

X 

£—(0,0) 

X 

X - p 

£+P 


Object 

Simplified 

x—x 

0 

0+£ 

£ 

(0,0) + £ 

X 

0 —x 

NEG(z) 

(0,0).-* 

NEG(*) 

£+0 

£ 


Multiplication and Division 


Object 

Simplified 

INV(i) 

— i 

»xINV(*) 

y/x 

y/mv(x) 

yxx 

0 X £ 

0 

(0,0) X£ 

(0,0) 

i X i 

-1 

1X £ 

£ 

( 1 ,0) x x 

£ 

(—1) X£ 

NEG(z) 

(—1,0) X£ 

NEG(x) 

£ X 0 

0 

£X(0,0) 

(0,0) 

£ X 1 

£ 


Object 

Simplified 

x x (1,0) 

£ 

X X (— 1) 

NEG(z) 

x x (—1,0) 

NEG(z) 

xjl 

£ 

x/0-fi) 

£ 

x/(-l) 

NEG(z) 

x / ( 1,0) 

NEG(*) 

0/£ 

0 

(0,0)/z 

(0,0) 

1/x 

INV(x) 

(1,0)* 

INV(£) 

(-1 )/* 

—INV(r) 

(-1,0)/* 

-INV(i') 
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Powers 


Object 

Simplified 

l x 

i 

m x 

(1.0) 

SQ(V(x)) 

X 

SQ(f®l 

y(2Xx) 

SQ(i) 

-1 

x Q 

1 

x(°>°) 

(1.0) 

X 1 

X 


Object 

Simplified 


X 

x'' — . 

rave*) 

art— 1 ' 0 ) 

INV(r) 

(^) 2 

X 

(^/x)( 2,0 ) 

X 


-1 

i( 2,°) 

(-i.o) 


Parts 


Object 

Simplified 

ABS(ABS(r)) 

ABS(x) 

ABS(NEG(x)) 

ABS(x) 

CONJ(CONJ(z)) 

X 

CONJ(IM(z)) 

IM(x) 

CONJ(RE(x)) 

RE(x) 

CONJ(«) 

Hi 

— l 

IM(CONJ(x)) 

. —IM(x) 

IM(IM(x)) 

0 

IM(RE(x)) 

0 

IM(p) 

0 

IM(i) 

1 

MAX(x,x) 

X 


Object 

Simplified 

MIN(x,x) 

X 

MOD(0,x) 

0 

MOD(i,z) 

0 

MQD(x,0) 

X 

x MOD y MOD y 

x MOD y 

RE(CONJ(x)) 

RE(x) 

RE(IM(x)) 

IM(x) 

RE(RE(x)) 

RE(x) 

RE(tt) 

7T 

RE(i) 

0 

SIGN(SIGN(x)) 

SIGN(x) 
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Symbolic Integration Patterns 

This table lists the symbolic integration patterns used by the HP 48. 
These are the integrands that the HP 48 can integrate symbolically. 

<f> is a linear function of the variable of integration. The antiderivatives 
should be divided by the first-order coefficient in 0 to reduce the 
expression to its simplest form. Also, patterns beginning with 1/ 
match INV: for example, 1/0 is the same as INV(0). 


Symbolic Integration 


Pattern 

Antiderivative 

ACOS(<2>) 

0xACOS(^)-v'(l-^ 2 ) 

ALOG(^) 

.434294481904 xALOG(0) 

ASIN(^) 

^xASIN(<£)+i/(l—c£ 2 ) 

ATAN(^) 

0xATAN(^-LN(1+<^ 2 )/2 

COS(<j>) 

SIN (</>) 

l/(COS($) x SIN (<j>)) 

LN(TAN(tf>)) 

COSH (<j>) 

SINH(^) 

l/(COSH(tf>)xSINH(<6)) 

LN(TANH($)) 

l/(COSH(tf>) 2 ) 

TANH(^) 

EXP(<£) 

EXP(^) 

: EXPM(^) 

EXP 

LN(<£) 

0xLN(<^)-0 

LOG(^) 

.434294481904 X 4> X LN (</>)- <f> 

SIGN(^) 

ABS(tp) 

SIN(0) 

-COS(<t>) 

l/(SIN(^)xCOS(0)) 

LN(TAN(0)) 

l/(SIN(^)xTAN(<^>)) 

-INV (SIN {4>)) 

l/(SIN(0)xTAN(</>)) 

—INV(SIN(<£)) 

1/(SIN(0) 2 ) 

—INV(TAN(^>)) 

SINH(^) 

COSH(^>) 

l/(SINH(^)x 2 

-INV(SIN(</.)) 
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Symbolic Integration (continued) 


Pattern 

Antiderivative 

l/(SINH(0)xCOSIl(0)) 

LN(TANH(0)) 

l/(SINH(0)xTANH(0)) 

—INV(SINH(0)) 

SQ (0) 

0 3 /3 

TAN(0) 2 

TAN(0)-0 

TAN(0) 

—LN(COS(0)) 

TAN(0)/COS(0) 

INV(COS(0)) 

1 /TAN (0) 

LN(S1N(0)) 

1 /TAN (0) x SIN (0)) 

—INV(S1N(0)) 

TANH(0) 

LN(COSH(0)) 

TANH(0)/COSH(0) 

INV(COSH(0)) 

1/TANH(0) 

LN(SINH(0)) 

1 /TANK (0) x SINH (0)) 

—INV(SINH(0)) 

70 

2x0 ls /3 

1/70 

2 x70 

1/(2 x7(0)) 

2x7(0) x.5 

<j> z (z symbolic) 

IFTB(^~-l,LN(0),0(^+ 1 )/(^+l)) 

<)> z (2 real, ^0,-1) 

0( 2 + 1 )/( 2 +l) 

4>° 

0 


LN(0) 

1/0 

LN(0) 

1/(1-0 2 ) 

ATANH(0) 

l/(l + 0 2 ) 

ATAN(0) 

l/(0 2 +l) 

ATAN(0) 

1/(V(0-1)XV'(0+1)) 

ACOSH(0) 

l/v / (l-0 2 ) 

ASIN(0) 

1/7U+0 2 ) 

ASINH(0) 

1/V(0 2 +1) 

ASINH(0) 
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Trigonometric Expansions 

The following tables list expansions for trigonometric functions in 
Radians mode when using the -^DEF, TRG*, and —»TRG operations. 
These operations appear in the Equation Writer RULES menu. 

-»DEF Expansions 
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TRG* Expansions 


Function 

Expansion 

SIN(ar + y) 

SIN(x) x COS(y ) + COS{x) x SIN(x) 

COS(x + y) 

COS(x) x COS(y) + SIN(x) x SIN(y) 

TAN(z + y ) 

TAN(x) + TAN(y ) 

1 - TAN(x) x TAN(y) 

SINH(ar + y ) 

SINH{x)xCOSH(y)+COSH(x)xSINH(x) 

COSH(a: + y) 

COSH(x) x COSH (y)+SINH (x) x SINH(y) 

TANH(x + y) 

TAN H(x) + TAN H(y) 

1 + TANH(x) x TANH{y) 


TRG Expansion 


Function 

Expansion 

EXP(zr) 

COS{*) + SIN{%) x i 

^ l 
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Source References 

The following references were used as sources for many of the 
constants and equations used in the HP 48. (See “References” in 
chapter 4, “Equation Reference,” for the references used as sources for 
the Equation Library.) 

1. E.A. Mechtly. The International System of Units, Physical 
Constants and Conversion Factors , Second Revision. National 
Aeronautics and Space Administration, Washington DC, 1973. 

2. The American Heritage Dictionary . Houghton Mifflin Company 
Boston, MA, 1979. 

3. American National Standard Metric Practice ANSI/IEEF Sid 
268-1982. The Institute of Electrical and Electronics Engineers, Inc., 
New York, 1982. 

4. ASTM Standard Practice for Use of the International System of 
Units (SI) E38l)-89a. American Society for Testing and Materials, 
Philadelphia, 1989. 

5. Handbook of Chemistry and Physics , 64th Edition, 1983-1984. CRC 
Press, Inc. Boca Raton, FL, 1983. 

6. International Standard publication No. ISO 31/1-1978 (E), 

7. The International Systein of Units (SI), Fourth Edition. The 
National Bureau of Standards Special Publication 330, Washington 

D.C., 1981. 

8. National Aerospace Standard. Aerospace Industries Association of 
America, Inc., Washington D.C., 1977. 

9. Physics Letters B , vol 204, 14 April 1988 (ISSN 0370-2693). 
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Parallel Processing with Lists 



Parallel processing is the idea that, generally, if a command can 
be applied to one or more individual arguments, then it can also be 
extended to be applied to one or more sets of arguments. 

Some examples: 


■ 5 INV returns . 2, so ■£ 4 5 8 

■ 45* returns 20, so £ 4 5 6 
and ( 45 6 )5 * returns £ 




INV returns £ „ 25 
C 5 6 7 y * returns 

c. • j 3 0 .*■. 




General Rules for Parallel Processing 

As a rule-of-thumb, a given command can use parallel list processing if 
all the following are true: 

■ The command checks for valid argument types. Commands that 
apply to all object types, such as DUP, SWAP, ROT, and so forth, 
do not use parallel list processing. 

■ The command takes exactly one, two, three, four, or five arguments, 
none of which may itself be a list. Commands that use an indefinite 
number of arguments (such as —►LIST) do not use parallel list 
processing. 

■ The command isn’t a programming branch command (IF, FOR, 
CASE, NEXT, and so forth). 

The remainder of this appendix describes how the many and various 
commands available on the HP 48 are grouped with respect to parallel 
processing. 

Group 1: Commands that cannot parallel process 

A command must take arguments before it can parallel process, since 
a zero-argument command (such as RAND, VARS, or REC) has no 
arguments with which to form a group. 


Parallel Processing with Lists G-1 



Group 2: Commands that must use DOUST to parallel process 

This group of commands cannot use parallel processing directly, but 
can be ’"coerced" into it using the DOLIST command (see “Using 
DOLIST for Parallel Processing” later in this appendix). This group 
consists of several subgroups: 

■ Stack manipulation commands. A stack manipulation command 
cannot parallel process because the stack is manipulated as a whole 
and list objects are treated the same as any other object. Stack 
commands (such as DROPN) that take level 1 arguments will not 
accept level 1 list arguments. 

■ Commands that operate on lists as wholes. Certain commands 
accept lists as arguments but treat them no differently than any 
other data object. They perform their function on the object as 
a whole without respect to its elements. For example, —>-STR 
converts the entire list object to a string rather than converting each 
individual element, and the == command tests the level 1 object 
against the level 2 object regardless of the objects' types. 


list manipulation commands. List manipulation commands will 
not parallel process since they operate on list arguments as lists 
rather than as sets of parallel data. However, a list manipulation 
command can be forced to parallel process lists of lists by using the 


the DOLIST command. For example, 
TIL I ST * D0LIST returns C 6 120 


1 


•i 4 5 6 J 


■ Other commands that have list arguments. Because a list can hold 

any number of objects of any type, it is commonly used to hold a 
variable number of parameters of various types. Some commands 
accept such lists, and because of this are insensitive to parallel 
processing, except by using DOLIST, 

■ Index-oriented commands. Many array commands either establish 
the size of an array in rows and columns or manipulate individual 
elements by their row and column indices. These commands expect 
these row and column indices to be real number pairs collected in 
lists. For example, *C 3 4 > RRNM will generate a random integer 
matrix having 3 rows and 4 columns. Since these commands can 
normally use lists as arguments, they cannot perform parallel 
processing, except by using DOLIST. 

■ Program control commands. Program control structures and 
commands do not perform parallel pro cessing and cannot be forced 
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to do so. However, programs containing these structures can be 
made to parallel process by using DO LIST. For example, C i 2 



IF DUP 3 ^ THEN DROP END * DOLIST returns 




Group 3: Commands that sometimes work with parallel processing 

Graphics commands that can take pixel coordinates as arguments 
expect those coordinates to be presented as two-element lists of binary 
integers. Since these commands can normally use lists as arguments, 
they cannot parallel process, except by using DOLIST. 


For the two-argument graphics commands (BOX, LINE, TLINE), 
if either argument is not a list (a complex number, for example), 
then the commands will parallel process, taking the list argument 
to be multiple complex number coordinates. For example, 

<0 ? 0> -f (1 ? 1 > <3n 2> > LINE will draw two lines—between (0.0) 


and (1,1) and between (0,0) and (3,2). 


Group 4: ADD and + 

On HP 48S and HP 48SX calculators, the + command has been used 
to append lists or to append elements to lists. Thus -C 1 2 3 > 4 + 
returns £ 1 2 3 4 >. With the advent of parallel processing in the 
HP 48G series, the ADD command was created to perform parallel 
addition instead of + . 

This has several ramifications: 


To add two lists in parallel, you must do one of the following: 


□ 


Use ADD from the fMTH] menu. 


a Create a custom menu containing the ADD command. 

Assign the ADD command to a user-defined key. 

User programs must be written using ADD instead of + if the 
program is to be able to perform direct parallel processing, or 
written with + and applied to their arguments by using DOLIST. 
For example, programs such as x 1 x+2 1 ft will produce list 
concatenation when x is a list rather than parallel addition, unless 


rewritten as <£ 


x RDD 2 


■ Algebraic expressions capable of calculating with variables 

containing lists (including those intended to become user-defined 
functions) cannot be created in RPN syntax since using 
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ADD to add two symbolic arguments concatenates the 
arguments with + rather than with ADD. For example, 
DUP 2 A SWAP 4 * ADD 1 FOO 1 SWAP = produces 

F , ■ v**« — V•-> _l A x, 'v* l 


1 X 1 




1 F<X)=X A 2 ADD 4*X 


Group 5: Commands that set modes/states 

Commands that store values in system-specific locations so as to 
control certain modes and machine states can generally be used to 
parallel process data. The problem is that each successive parameter 
in the list cancels the setting established by the previous parameter. 
For example, £ 1 2 3 4 5 > FIX is effectively the same as 5 FIX. 


Group 6: One-argument, one-result commands 

These commands are the easiest to use with parallel processing. 
Simply provide the command with a list of arguments instead of the 

expected single argument. Some examples: 


£ 1 - 
DEG < 
£ 1 A 


3 -4 > ABS returns £ 1 2 
0 30 60 90 > SIN returns 
•SINtZ) 1 > INV returns C 






*"1^7! i 
•„* 1 S - 1 








I 


Group 7: Two-argument, one-result commands 

Two-argument commands can operate in parallel in any of three 
different ways: 


■ £ list y £ list > 

■ £ list > object 
m object £ list 3- 


In the first form, parallel elements are combined by the command: 


1 23 > £ 4 5 6 


returns 



1 


1 




In the second form, the level 1 object is combined with each element 
in the level 2 list in succession: 





CH returns £ 



900 1400 900 



In the third form, the level 2 object is combined with each element of 


the level 1 list in succession: 
50 £ 1 2 3 } XT returns £ 2 




* 
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Group 8: Multiple-argument, one-result commands 


Commands that take multiple (3, 4, or 5) arguments can perform 
parallel processing only if all arguments are lists. For example, 


r 

I c 

i 

■J 


SINCX) 


COS<X>' 1 TflhKX) 


V V V 

r i ."i n 


> £ 0 0 0 > ROOT 


returns £ 0 90 0 >. Notice that lists must be used even though the 
level 1 and level 2 lists each contain multiples of the same element. 


Group 9: Multiple-result commands 

Any command that allows parallel processing, but produces multiple 
results from its input data, will return its results as a single list. For 
example, £ 1 2 3 > £ 4 5 6 } R*C C*R produces £ 142 5 3 6 } 
rather than the more expected £ 1 2 3 1 £ 4 5 6 }. 


The following UN MIX program will unmix the data given the number 
of expected result lists: 


■ft UVER SIZE * 1 n s 


& 


k 1 n 
FOR j j s 
FOR i 1 i GET n 



s n 


*LIST 


NEXT 


s- 


»• 


Taking £ 1 4 2 5 3 6 > from above as the result of C—>R (a 
which should return two results), 2 UNMIX gives £ 12 3 > { 



4 5 6 



Group 10: Quirky commands 

A few commands behave uniquely with respect to parallel processing: 

■ DEL ALARM. This command can take a list of arguments. Note, 
however, that deletions from early in the alarm list will change the 
alarm indices of the later alarm entries. Thus, if there are only three 
alarms, £ 1 3 > DELflLRRM will cause an error, whereas £ 3 1 > 
DELflLflRM will not. 

■ DO ERR. This command forces an error state that causes all 
running programs and commands to halt. Thus, even though 
providing the command with a list argument will cause the 
command to perform parallel processing, the first error state 
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will cause the command to abort and none of the rest of the list- 
arguments will be used. 

■ FREE, MERGE. Only port 1 can be freed or merged on the 

IIP 48GX. Thus, even though a list argument is acceptable, an error 
will occur for any list except t i >, 

■ RESTORE. This command performs a system war ms tart after 
instailing the backup object into memory. All functions are 
terminated at that time. Thus, only the first backup object in a list 
will be restored. 


_ (Attach Unit). This command will create unit objects in parallel 
only if level 1 contains a list. Thus 1 C ft in n > _ produces -C 


j. 


ft Lin in > while C 1 


i i 

Pi 


produces an error. 


■ STO+. STO+ performs parallel list addition only if both arguments 
are lists. If one argument is a list and the other is not, STO+ 
appends the non-list argument to each element in the list. 

■ STO-, STQ*, STO/. These commands perform parallel processing 

if both arguments are lists, but fail otherwise. 


Using DOLIST for Parallel Processing 

Almost any command or user program can be made to work in parallel 

over a list or lists of data by using the DOLIST command. Use 

DOLIST as follows. 

■ Level 1 must contain a command, a program object, or the name of 
a variable that contains a command or program object. 

■ Level 2 must contain an argument count unless the level 1 object is 
a command that accepts parallel processing, a program containing 
only one command that accepts parallel processing, or a user-defined 
function. In these special cases, Level 2 contains the first of the list 
arguments. 

■ If level 2 was the argument count, then level 3 is the first of the 
argument lists. Otherwise, levels 2 through n are the argument lists. 


G-6 Parallel Processing with Lists 



As an example, the following program takes three objects from the 
stack, tags them with the names a, b, and c, and displays them one 
after the other in line 1 of the display. 


•£ * a fa c 
« i a fa > 


> DUP « EVflL :$■ SOL I ST 


SWAP * +TRG * DOLIST 


CL LOS i * i DISF 1 NR IT :# DOLIST 


* 
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Index 


Special characters 

i character, 1-10 

A 

absolute value, 3-5 
alarms 

acknowledging, 3-6 
deleting, 3-78 

finding, 3-116 

index number, 3-116 

recalling, 3-262 
storing, 3-326 
RLG annunciator, 1-9 
algebraic 

linear structure, 1-20 
Algebraic/Program-entry mode, 

1-9, 1-63 

algebraics 

action in programs, 1-2 
collecting terms, 3-56 
comparing, 1-19 
conditional testing, 1-22 
editing in programs, 1-9 
expanding, 3-109 
in local variable structure, 

1- 3, 1-11 

isolating variables, 3-158 
rearranging, 3-104, 3-158 
rearranging programmatically, 

2- 19 

simplifying, 3-56 
testing for linearity, 3-168 


tests in, 1-19 

algebraic syntax 

conditional testing, 1-22 
in local variable structures, 

1-4 

test commands, 1-17, 1-19 
alpha keyboard 

automatically locking, 1-63 
amortization (TVM), 3-12 

angle mode 

setting, 3-78, 3-131, 3-256 

angles 

converting units, 3-99, 3-294 
angular mechanics, 4-29 
angular motion, 4-48 

animation, 2-45, 2-56, 3-14 

annunciators 
user flags, 1-42 
applications, 1-79 
archives 

creating, 3-18 
arcs, 3-17 
arguments 

comparing, 3-183, 3-191 
recalling last, 3-162, 3-163 
verifying, 2-36 

arrays 

applying a program to, 2-29 
column norm, 3-53 
complex conjugates, 3-62 
constant, 3-59 
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creating from stack, 3-20, 

3-369 

deleting columns, 3-55 
disassembling, 3-19 
disassembling complex, 3-71 
extracting elements, 3-127, 

3-129 

Fourier transforms, 3-115 
inserting columns, 3-54 
inserting diagonals, 3-84 
inverse Fourier transform, 

3-147 

manipulating, 2-16, 2-49 

maximum and minimum 
elements, 2-22 
redimensioning, 3-266 
replacing elements in, 3-244, 

3-246 

residual, 3-291 
row norm, 3-280 
sorting elements, 2-23 
spectral norm of, 3-314 
swapping columns, 3-70 
symbolic, 2-29 
axes (plots) 

controlling, 3-33 
including, 3-95 
labeling, 3-162 

B 

backup objects, 3-248 
creating, 3-18 
restoring, 3-273 
bar graphs, 3-34 

base 

setting, 3-38, 3-75, 3-137, 
3-210 

baud rate 

specifying, 3-36 
beams, 4-1 


beeper 

in programs, 1-71 
sounding, 3-37 

specifying tone and duration 

3-37 

Bernoulli equation, 4-23 
Bessel functions, 2-43 
binary integers 
comparing, 1-19 
converting to floating-point, 

3-42 

custom display, 2-7 
representing flags, 1-44 
shifting one bit right, 3-25 
wordsize, 1-19, 3-335 

binary wordsize 

recalling, 3-265 
bipolar transistors, 4-73 
bit 

rotate left, 3-278 
rotate right, 3-285 
shift left, 3-310 
shift right, 3-317 

black-body emissive power, 
3-112 

black body radiation, 4-42 
boxes, 3-40 

branch cuts, 3-7, 3-9, 3-21, 
3-23, 3-26, 3-29 

branching structures 

conditional structures, 1-20, 

1-53, 3-101 
ending, 3-102 
loop structures, 1-27 
program element, 1-3 
BRCH menu, 1-20, 1-27 
Brewster angle, 4-52 
buckling, 4-3 
buffer (serial) 
clearing, 3-51 
sizing data in, 3-40 
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byte 

rotate left, 3-278 
rotate right, 3-285 

shift left, 3-311 
shift right, 3-318 

C 

calculator 

turning off, 1-82 
calculator clock. 2-5 
cantilevers, 4-1 

capacitor, 4-16, 4-17, 4-19, 4-20 
“case” branching, 1-22, 2-38, 
2-49, 3-42 

case structures, 2-49 
centripetal force, 4-29 
character codes 

remapping to match HP 

82240A, 3-211 
to characters, 3-48 
characters 
codes, 3-204 

character translation, 3-352 
checksums, 3-41 
specifying type of, 3-49 
verify programs, 2-1 
chi-square distribution, 3-363 
choose boxes 

custom, 1-68, 3-46 

in programs, 1-68 

circle, 4-59, 4-79 
circular motion, 4-49 

clearing 

command line, 3-50 
directories, 3-53 
display, 1-74 
flags, 1-42, 3-45 
stack, 3-50 
stack display, 3-51 

subdirectories, 3-52 

variables, 3-52, 3-53 


clock 

adjusting, 3-50 

coefficients 

of monic polynomials, 3-220 
regression, 3-177 
collisions, 4-30 
column operations 

converting matrices into 
columns, 3-54 

converting vectors into 
elements, 3-54 
creating matrices from 
columns, 3-56 

creating vectors from elements, 

3-56 

deleting, 3-55 
inserting, 3-54 
columns, 4-1 
combinations, 3-58 
command line 

clearing, 3-50 

during program input, 1-62 
commands 

applying to list elements, 

3-92, 3-102, 3-203 

applying to lists, 3-91 

in programs, 1-2 
comments, 1-10 

comparing objects, 3-294 
comparison functions, 1-17, 

1-19 

compiled local variable structures 
defining procedure, 1-15 
complex numbers 
conjugates, 3-62 
disassembling, 3-71 
imaginary parts, 3-150 
polar angle 3-19 

real parts, 3-267 

computer 

creating programs on, 1-10 
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conditional commands, 1-20, 
1 - 21 . 1-22 
conditionals 

nested, 2-23, 2-26, 2-36 

conditional structures 

“case” branching, 1-22, 3-42 

conditional commands, 1-20 
ending, 3-102 

error branching, 1-53, 1-54, 
3-146 

examples, 1-23 

“if* branching, 1-20, 1-21, 

1-22, 1-53, 1-54, 3-101, 
3-144, 3-148, 3-149 

program element, 1-3 
test commands in, 1-17, 1-20 
conduction, 4-39, 4-41 
cone, 4-64 

conjugates, 3-62 

of matrices, 3-353 
of objects, 3-300 

constants 

symbolic, 3-99, 3-143, 3-183, 
3-193 

Constants Library 
opening, 3-63 

continuing execution, 1-47, 

1-48, 1-57, 1-59, 3-64 
convection, 4-40, 4-41 

converting base units, 3-360 
coordinate modes 

specifying, 3-70, 3-269, 3-316 

coordinates 

pixels to user units, 3-250 
specifying for PICT , 3-231 
user units to pixels, 3-71 
coordinates of PICT 
specifying, 3-231 
correlation (statistical), 3-65 
Coulomb’s law, 4-11 


counters 

loop structures, 1-29, 1-31, 

1-33, 1-35 

negative steps, 1-31, 1-35, 
1-39 

stepping, 1-39 

covariance, 3-222 

creating 2D vectors, 3-369 
creating 3D vectors, 3-370 
critical angle, 4-51 
current, 4-9, 4-43, 4-67 
cursor (command line), 1-63 
curve fitting, 3-37, 3-110, 3-166 
3-167, 3-176, 3-250 

custom menus 
creating, 3-187 
displaying, 3-187 
in programs, 1-78, 1-79 

menu-based applications, 

1-79 

cylinder, 4-64 

D 

Darcy friction factor, 3-72 
data input, 3-154 
data transmission 

closing ports, 3-51 
detecting errors, 3-49 
error testing, 3-40 
parity, 3-217 

receiving, 3-268, 3-269 
serial, 3-381 
size of, 3-40 

specifying baud rate, 3-36 
terminating Server mode, 

3-117 

time-out, 3-324 
via Kermit, 3-160, 3-301 
via Kermit server, 3-160, 
3-303 
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data transmissions 
opening ports, 3-212 
dates 

calculating days between, 

3-75 

calculating past or future, 

3-74 

displaying, 3-73, 3-356 
setting, 3-73 

debugging, 1-47, 1-49, 3-74, 
3-201 

decomposing vectors, 3-371 
defining procedures 

compiled local variables in, 

1-15 - 

local variables in, 1-14 
local variable structures, 1-11 

definite loops, 2-3, 2-26, 2-46, 

2- 47, 2-49, 2-56 

with counters, 2-10, 2-16 
delimiters 

■£ & for programs, 1-1 
dependent variables 
specifying in matrices, 3-389 
specifying in plots, 3-81 
specifying in statistical data, 

3-57 

summation of squares, 3-389 
summations of, 3-388 
dialog boxes (input forms), 

3- 152 

dimensions 

converting, 3-65 

of PICT, 3-223 
diodes, 4-69 
directories 

changing, 3-142, 3-363 
clearing, 3-53 
creating, 3-69 
current, 3-142 
HOME, 3-142 


paths, 3-219 
purging, 3-225 
display 

area numbers, 1-59 
clearing, 1-74 
clearing stack, 3-51 

creating graphics objects from, 

3-163 

freezing, 1-58, 3-123 
printing, 3-237 

display mode 

setting, 3-103, 3-117, 3-299, 
3-322 

“do” looping, 1-36, 2-19, 2-23, 
2-43, 3-89, 3-362 

drag force, 4-31 

E 

editing 

programs, 1-9 
eigenvalues 

of matrices, 3-100, 3-101 

eigenvectors 

of matrices, 3-100 
elastic buckling, 4-3 
elastic collisions, 4-30 
electricity, 4-9 
electrostatic force, 4-11 
ellipse, 4-59 
energy, 4-15, 4-31 
Equation Library 

references, 4-1, 4-82 
starting, 3-104 
subjects, 4-1 
titles, 4-1 

equations 

defining sets, 3-193 
disassembling, 3-104 
expanding, 3-109 
least squares solution, 3-178 
rearranging, 3-104 
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recalling, 3*259 
reordering sets, 3*194 
retitling sets, 3-194 
sets, 3-194 

solving linear systems. 3-178 
solving quadratic. 3-253 
solving sets, 3-197 
testing for linearity, 3-168 
equation sets 

changing titles, 3-194 
defining, 3-193 
reordering, 3-194 
solving, 3-197 
errors 

actions in programs, 1-51 
analyzing, 1-51 
causes, 1-51 

causing, 1-51, 3-90 
clearing last, 1-51, 3-106 
conditional structures, 1-53, 
1-54, 3-146 

detecting in transmission, 

3-49 

display messages, 1-51 
Kermit, 3-159 
numbers for, 1-51, 3-106 
recalling messages, 1-51, 

3-105, 3-159 

trapping, 1-53, 1-54, 3-146 

user-defined, 1-51 
error-trapping, 2-29 
error trapping, 2-9, 2-10 
escape velocity, 4-49 
evaluation 

of local variables, 1-13 
of test clauses, 1-21, 1-22, 

1-36, 1-38 

example program 

UNMIX, G-5 


example programs 

animating graphics, 2-45, 
2-47, 2-56 

applying programs repeatedly, 

2-19 

Bessel functions, 2-43 
calculating median, 2-14 
converting from algebraic to 

RPN, 2-40 

converting plots to grobs, 

2-45 

custom menus, 1-80 
displaying binary integers, 
2-10 

execution times, 2-5 
Fibonacci numbers, 2-2 
input forms, 1-67 
input routines, 1-54, 1-57, 

1- 60, 1-64, 1-66 

inverse functions, 2-54 
manipulating math curves, 

2- 46 

mass of an object, 1-79 
maximum and minimum 
elements, 2-22 
percentile of a list, 2-14 
phone list, 1-67 
plotting pie charts, 2-49 
preserving calculator status, 
2-8 

rearranging algebraics, 2-19 
right-justifying strings, 2-7 
summations, 1-41 
surface area of a torus, 1-45 
system flags, 1-43 
Taylor’s polynomials, 2-45 
trace mode, 2-53 
using conditionals, 1-23, 1-24, 
1-25, 1-26 

using loops, 1-29, 1-31, 1-33, 
1-35, 1-37, 1-40 
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verifying arguments, 2-36 
volume of a sphere, 1-5, 1-6 
volume of a spherical cap, 

1- 6, 1-9, 1-12 

Examples subdirectory 
creating, 3-345 
removing, 3-52 
exponents, 3-383 
expressions 

creating from arguments, 

3-15 

pattern replacement, 3-180, 

3-181 

rewriting, 3-180, 3-181 
extrapolation, 3-234, 3-235, 
3-236 

factorials, 3-112 
factor units, 3-361 
false (test result), 1-17, 1-19 
Fanning friction factor, 3-113 
F distribution, 3-364 

Fibonacci numbers, 2-2 

flags 

annunciators, 1-42 
binary integer form, 1-44 
clearing, 1-42, 3-45, 3-114, 
3-125 

control behavior, 1-42 
controlling logic with, 2-23, 

2- 26 

default states, C-l 
preserving and restoring 

status, 2-8, 2-9, 2-49 

program control, 1-42 
recalling, 3-262 
recalling states, 1-44 
restoring states, 1-44 
setting, 1-42, 2-10, 2-23, 2-26, 
2-53, 3-304, 3-327 


storing states, 1-44 
system, 1-42, 1-44, C-l 
testing, 1-42, 2-23, 2-26, 

3-114, 3-124, 3-125 
testing and clearing, 3-114, 

3-125 

types, 1-42 

user, 1-42, 1-44 
fluid flows 

Darcy friction factor, 3-72 
Fanning friction factor, 3-113 
fluids, 4-22 
focal length, 4-50 
force, 4-11, 4-27, 4-44 
“for” looping, 1-32, 1-34, 2-10, 
2-16, 2-26, 2-46, 2-47, 2-49, 

2- 56, 3-119, 3-201 

formatting 

ports, 3-228 

Fourier transforms 
inverse, 3-147 
of arrays, 3-115, 3-147 
free fall motion, 4-47 
freeing merged memory, 3-121, 

3- 122 

frequency 

resonant, 4-19 
friction losses, 4-26 
functions 

applying to list elements, 

3-92, 3-102, 3-203 
applying to lists, 3-91 
defining, 3-77 

G 

gamma function. 3-112 
gas compressibility correction 

factor, 3-393 

gas-compressibility factor, 4-36 
gases, 4-32 
geometry, 4-58, 4-63 
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global variables 

action in programs, 1-2 
disadvantages in programs, 

1-11 

list of, 3-357 

graphics 

creating, 3-17, 3-40, 3-131, 
3-166, 3-227 

custom, 2-56 

displaying, 3-249 
environment, 3-131 
Picture environment, 3-227 
graphics commands 

parallel processing with, G-3 
graphics objects 
animating, 3-14 
creating blank, 3-39 
creating from display, 3-163 
creating from stack, 3-133 
displaying, 3-164 
manipulating, 2-23. 2-46, 

2-47, 2-49, 2-56 
superimposing, 3-130, 3-134 
gravitation, 4-31, 4-47, 4-48, 
4-49 

H 

HRLT annunciator, 1-47, 1-59 
halting programs, 1-48, 3-136 

harmonic motion, 4-54 
head loss, 4-24 
heat, 4-37 
heat capacity, 4-38 
heat transfer, 4-37 
histograms, 3-137, 3-139 
HMS format 
adding in, 3-139 
converting from, 3-141 
converting to, 3-142 
subtracting in, 3-140 
Hooke’s law, 4-30 


I 

ideal gases, 4-32 

“if” branching, 1-20, 1-21, 1-22, 

1- 53, 1-54, 2-2, 2-23, 2-26, 

2- 36, 3-101, 3-144, 3-148, 

3- 149, 3-346 

“iferror” branching, 2-29 
implicit variable references, 

3-305 

indefinite loops, 2-7, 2-19, 2-23 
ending, 3-89, 3-102, 3-374 
with counters, 2-43 
independent variables 

specifying for plotting, 3-151 
specifying in matrices, 3-380 

specifying in statistical data, 

3-57 

summation of squares, 3-379 
summations of, 3-379, 3-388 
index of refraction, 4-50 
inductor, 4-17, 4-20, 4-21 
initial value problems, 3-274 
error estimate, 3-276, 3-290 

next step, 3-288 
solution step size, 3-277 
with known partials, 3-286 
input 

prompting for, 3-238 
input forms 
creating, 3-152 
custom, 1-67, 3-152 
for program input, 1-67 
in programs, 1-67 
resetting, 3-203 
saving initial values, 3-203 
input plane 

setting the x range, 3-387 
setting the y range, 3-393 
intrinsic density of silicon, 3-305 
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inverses 

calculating, 3-156 

logical, 3-201 
of matrices, 3-156 
storing, 3-309 
I/O 

closing ports, 3-51 
IR port, 3-157 
Kermit errors, 3-159 
Kermit transmission, 3-160 
selecting port, 3-157 
serial port, 3-157 
isothermal expansion, 4-34 

J 

junction field-effect transistors, 

4-74 

K 

Kermit, 3-212, 3-217, 3-230, 
3-268, 3-269, 3-301, 3-303 

error messages, 3-159 
server, 3-160 
transmission, 3-160 
keyboard 

defining user, 3-24, 3-328 
in programs, 1-72, 1-73 
recalling definitions, 3-263 
unassigning user keys, 3-80 
key location numbers, 1-73 
keys 

defining in user keyboard, 
3-24 

testing, 3-159 
keystrokes 

as program input, 1-72, 1-73 

waiting for , 3-373 
killing programs, 1-47, 1-48, 
3-161 


L 

last argument 

recalling, 2-10. 3-162, 3-163 
length factor, 4-3 
libraries 

attaching, 3-31 
detaching, 3-84 
displaying menus, 3-187 
listing, 3-165 

light, 4-50 

linear mechanics, 4-28 
linear motion, 4-47 
linear structure. 1-20 

lines, 3-166 

list concatenation, G-3 
list processing 

programming example, 2-29 
lists 

action in programs, 1-2 
adding elements of two, 3-11 
applying commands, functions, 
or programs to, 3-91, 

3-92, 3-102, 3-203, 3-302, 
3-333, 3-336 

applying executable object 
repeatedly, 3-302 
assembling, 3-169 
creating from stack, 3-169 
differences between elements, 

3-170 

disassembling, 3-169 
extracting elements, 3-127, 

3-129, 3-136, 3-341 
first element, 3-136 
last elements, 3-341 
locating objects in, 3-234 
multiplying elements of, 3-171 
parallel processing, G-l 
product of, 3-171 
replacing elements in, 3-244, 

3-246 


Index-9 



reversing element order, 3-274 

sorting, 2-14, 3-315 
sublist position in, 3-203 
summing elements of, 3-170 
local variables, 2-9 

action in programs, 1-2 
compiled, 1-15 
creating, 1-3, 1-11 

evaluating, 1-13, 2-19 

exist temporarily, 1-11, 1-12, 

1- 14 

naming, 1-11 

nested, 2-43, 2-49 

passing between programs, 

2- 47 

storing objects in, 2-19. 2-38 
local variable structures 
advantages, 1-12 
as user-defined functions, 

1-16 

calculations with, 1-3 
create local variables, 1-11 
defining procedure, 1-11, 1-14 

entering, 1-11 

operation, 1-3, 1-11 
program element, 1-3 
syntax, 1-3, 1-11 

logic 

controlling, 2-26 

controlling with flags, 2-23, 

2-26 

functions, 2-23, 2-26, 2-36, 

2-38 

logical functions, 1-17, 1-19, 

3-13, 3-201, 3-213, 3-382 

longitudinal waves, 4-81 
loop structures 

counters, 1-29, 1-31, 1-33, 

1-35, 1-39, 3-323 


definite, 1-27, 1-28, 2-3, 2-26, 

2- 46, 2-47, 2-49, 2-56, 

3- 119, 3-201, 3-321 
"do” looping, 1-36, 3-89 
“for” looping, 1-32, 1-34, 

3-119, 3-201, 3-323 
indefinite, 1-27, 1-36, 2-7, 

2- 19, 2-23, 3-374 

keystroke input, 1-73 
negative steps, 1-31, 1-35 
program element, 1-3 
“start” looping, 1-28, 1-30, 

3- 201, 3-321 

summation alternative, 1-40 
test commands in, 1-36, 1-38 
“while” looping, 1-38 
lowercase letters 
in names, 1-11 

M 

Mach number, 4-35 
magnetic field, 4-15, 4-43, 4-44, 

4-45 

magnetism, 4-43 
magnification, 4-50 
mantissas, 3-179 

mass 

related to energy, 4-31 
mathematical data 
plotting, 3-94 
matrices 

adding rows, 3-283 
condition number, 3-60 
conjugates of, 3-353 
converting to columns, 3-54 
converting to rows, 3-282 
creating from columns, 3-56 
creating from rows, 3-284 
deleting rows, 3-284 
determinants, 3-82 
eigenvalues, 3-101 
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eigenvalues and eigenvectors, 

3-100 

extracting diagonals, 3-85 
identity, 3-143 
inverting, 3-156 
least squares solution, 3-178 
LQ factorization, 3-176 
LU decomposition, 3-179 
multiplying rows by a 
constant, 3-260 

QR factorization, 3-253 
random element, 3-257 
rank of, 3-257 

reduced row echelon form, 

3-286 

Schur decomposition, 3-298 
singular value decomposition, 

3-337 

singular values of, 3-338 
spectral radius, 3-317 
squaring, 3-316 

sum of diagonal elements, 

3-351 

swapping rows, 3-292 
transposing, 3-353 
mechanics, 4-28, 4-29 
memory 

checking available, 3-186 
freeing merged, 3-121 
merging RAM card, 3-190 
menu-based applications, 1-79 
menu descriptions 

PRG BRCH, 1-20, 1-27 
PRO RUN, 1-49 
PRG TEST, 1-18 

menus 

custom, 1-78, 1-79, 2-23, 
3-187 

defining, 3-187 
delayed display, 1-72, 1-78 
displaying, 3-187 


displaying in programs, 1-72, 

1-77, 1-79 
for libraries, 1-77 
for program input, 1-79 
last menu, 1-78 
numbers for, 1-77, 1-78, 3-264 
pages in, 1-78 
programmatic uses, 1-77 
recalling, 3-264 
recalling numbers, 1-78 
resuming programs, 1-79 
running programs, 1-79 
temporary, 2-49, 3-350 

message boxes 

creating, 3-196 
custom, 1-77, 3-196 
in programs, 1-77 
messages, A-1-17 
displaying, 3-88 
prompting, 1-56 
meta-objects, 2-29 
Minehunt game, 3-192 
cheating, 3-192 
storing, 3-192 
mode names 

Algebraic-entry, 1-63 
Algebraic/Program-entry, 

' 1-9, 1-63 

Program-entry, 1-4, 1-9 

modes 

program entry, 1-4, 1-9 

setting, 1-9 
Mohr’s circle, 4-79 
motion, 4-46 

N 

names 

action in programs, 1-2 

negatives, 3-199 

nested structures, 2-40, 2-43 

new commands, E-l-7 
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newlines, 1-4, 1-59 
NMOS transistors, 4-71 

nonideal hydrocarbon gas, 3-393 

normal distribution, 3-365 
NPN bipolar transistors, 4-73 
number bases 

converting between, 2-32 
numbers 

action in programs, 1-2 

complex, 3-19 
complex conjugates, 3-62 
disassembling complex, 3-71 
fractional part, 3-121 
imaginary parts, 3-150 
integer part, 3-157 
largest available, 3-183 
rational form, 3-251 
rational form with tt, 3-251 
real parts, 3-267 
real to binary, 3-292 

real to complex, 3-293 
rounding, 3-279 
rounding to integer, 3-44, 
3-118 

smallest available, 3-193 
squaring, 3-316 

O 

objects 

actions in programs. 1-2 

backup, 3-248 
comparing, 3-294 
conjugates, 3-300 
converting dimensions, 3-65 
copying, 3-200, 3-226 
decomposing, 3-209 
displaying, 3-88 
duplicating, 3-97, 3-98 

entering in programs, 1-4 
evaluating, 3-107 
evaluating by addresses, 3-339 


evaluating symbolic, 3-207 
operating system, 3-339 
printing, 3-241 
recalling, 3-261 
removing from stack, 3-95, 

3-96 

removing labels from, 3-97 
removing pointers to, 3-200 
replacing a portion of, 3-270 
sign of, 3-306 
size of, 3-41, 3-309 
storing, 3-325 

storing in reserved variables, 

3-324 

storing objects in, 3-325 
testing types, 1-20 
truncating, 3-353 

type numbers, 1-20 
type numbers of, 3-359 
unevaluated, 3-254 
object type numbers, 1-20 
Ohm’s law, 4-11 
optics, 4-50 
oscillations, 4-54 
output 

labeling, 2-5 

P 

packets 

sending, 3-230 
parallel addition, G-3 
parallelepiped, 4-65 
parallel processing, G-l 

DOLIST, G-2, G-6 

multiple-result commands, 

G-5 

parity 

setting, 3-217 
pendulum, 4-56, 4-57 
percent functions, 3-47, 3-339 
permutations, 3-224 
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phase delay, 4-16 
PICT , 3-226 
clearing, 3-105 
editing, 3-17, 3-40, 3-166 
specifying coordinates, 3-231 
superimposing grobs onto, 

3-130, 3-134 

Picture environment 

selecting, 3-131, 3-227 
pie charts, 2-49 
pixels 

checking if on, 3-229 
coordinates, 3-71, 3-250 
toggling, 3-349 
turning off, 3-228 
turning on, 3-229 
plane geometry, 4-58 
plots 

3D, 3-207, 3-208 
3D perspective, 3-111 
autoscaling, 3-32 
center, 3-44 

changing horizontal width, 

3-372 

controlling axes, 3-33 
creating, 3-36 
drawing, 3-94, 3-139, 3-296 
drawing axes, 3-95 
labeling axes, 3-162 
mathematical data, 3-94 
resolution, 3-207, 3-208, 3-271 
scaling, 3-135, 3-299 

setting axes tick-marks, 3-30 

setting types, 3-34, 3-61, 3-86, 
3-125, 3-132, 3-137, 3-215, 
3-296, 3-297, 3-355, 3-375, 
3-391 

simultaneous, 3-307 
specifying dependent variable, 

3-81 

specifying eye point, 3-111 


specifying x-axis display range, 
3-384 

specifying y-axis display range, 

3-390 

statistical data, 3-36, 3-94, 
3-137, 3-139 

plot types 

setting, 3-218, 3-221, 3-312 
specifying, 3-232 
plug-in cards 

initializing, 3-228 
PN step-junction devices, 4-69 
polarization, 4-52 
polygon, 4-61 

polynomials 

evaluating, 3-224 
monic, 3-220 

roots, 3-238 

Taylor J s, 3-343 
poly tropic processes, 4-34 
population covariance, 3-222 
population standard deviation, 

3-242 

population variance, 3-247 
port 

opening, 3-212 
selecting, 3-157 
ports 

closing, 3-51 
initializing, 3-228 
pressure 

hydrostatic, 4-23 

PRG annunciator, 1-4, 1-9 

PRO BRCH menu, 1-20, 1-27 
PRG RUN menu, 1-49 
PRG TEST menu, 1-18 

print buffer 
printing, 3-68 
printing 

HP 82240A, 3-211 
print buffer, 3-68 
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setting delay, 3-79 

trace mode, 2-53 
Program Development Link, 
1 - 10 , 2-1 

programs included, 2-1 
Program-entry mode, 1-4, 1-9 
program examples 

arbitrary number bases, 2-32 
programming techniques 
applied list processing, 2-29 

“case” branches, 2-38, 2-49 
case structures, 2-38, 2-49 
controlling logic with flags, 

2-23, 2-26 

custom graphics, 2-56 
custom menus, 2-23, 2-26 

definite loops, 2-3, 2-26, 2-46, 
2-47, 2-49, 2-56 

definite loops with counters, 
2-10, 2-16 

“do” loops, 2-19, 2-23, 2-43 

error-trapping, 2-29 
error trapping, 2-9, 2-10 
evaluating local variables, 

2-19 

“for” loops, 2-10, 2-16, 2-26, 

2-46, 2-47, 2-49, 2-56 
“if’ branches, 2-23, 2-26 
indefinite looping, 2-33 
indefinite loops, 2-7, 2-19, 
2-23 

indefinite loops with counters, 

2-43 

interpolation, 2-14 
labeling output, 2-5 
list concatenation, 2-40 
local variables, 2-9, 2-38, 
2-43, 2-47, 2-49 

logical functions, 2-23, 2-26, 

2-36, 2-38 

logic control, 2-26 


manipulating grobs, 2-23, 

2-46, 2-47, 2-49, 2-56 

meta-object manipulation, 

2-29 

nested conditionals, 2-23, 

2-26, 2-36 

nested structures, 2-40, 2-43 
object type-checking, 2-40 
plot commands, 2-45, 2-46, 
2-49 

preserving flag status, 2-9, 

2-49 

programs as arguments, 2-10, 

2-19, 2-54 
recursion, 2-2, 2-40 
restoring flag status, 2-9, 

2-49 

restoring last argument, 2-10 
root-finder, 2-54 
setting flags, 2-10, 2-23, 2-26, 
2-53 

simulating new object types, 

2-29 

sorting array elements, 2-23 
sorting lists, 2-14 
“start” loops, 2-3 

string and character 
manipulation, 2-33 
string operations, 2-7 
structures, 2-5 
subroutines, 2-5, 2-10, 2-21, 
2-38 

tagged output, 2-33 
temporary menus, 2-49 
testing flags, 2-23, 2-26 
using arrays, 2-16, 2-49 

using calculator clock, 2-5 

using flags, 2-29 

using other programs, 2-5, 

2-10, 2-21, 2-38 
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using statistics commands, 

2- 49 

utility programs, 2-38 
vectored enter, 2-53 
“while” loops, 2-7 
programs 

actions for object types, 1-2 
applying to elements of a 
matrix, 2-29 

applying to list elements, 

3- 92, 3-102, 3-203 

applying to lists, 3-91 
are sequences of objects, 1-1 
beeping, 1-71 
calculation styles, 1-3 
cancelling halted, 3-161 
causing errors, 1-51 
checksums, 2-1 
comments in, 1-10 
conditional structures, 1-20, 

1-53, 1-54 

creating on computer, 1-10 
cursor position during input, 

1-63 

debugging, 1-47, 3-74, 3-201 

default input, 1-60 
displaying input forms, 1-67 

displaying menus, 1-72, 1-77, 
1-79, 2-23, 2-26, 2-49 
displaying output, 1-74, 1-75, 
1-76 

displaying string output, 1-75 
editing, 1-9 
elapsed time, 2-5 
entering, 1-4 
entry modes. 1-4, 1-9 
entry modes during input, 

1-63 

error actions, 1-51 
evaluating local variables, 

1-13 


executing, 1-5 
finding roots in, 2-54 
flags in, 1-42 

getting input, 1-55, 1-56, 
1-58, 1-60, 1-72, 1-73, 
3-154 

HALT annunciator, 1-47 

halting, 1-48, 3-136 

in local variable structure, 

1-3, 1-11 

input as strings, 1-60 
input forms, 3-152 
introduction, 1-1 

killing, 1-47, 1-48, 3-161 
labeling output, 1-74, 1-75 
local variable structures, 1-3, 
1-11 

loop structures, 1-27, 3-89, 
3-374 

naming, 1-5 

newlines in, 1-4 

not evaluating local variables, 

1-13 

not executing in programs, 
1-2 

objects in, 1-2 
on the stack, 1-4 
pausing, 3-373 
pausing for output, 1-76 
prompting, 1-56, 1-58, 1-60, 
3-154 

recursion, 2-2 
resuming, 1-47, 1-48, 1-56, 
1-59, 1-79, 1-82, 3-64 
samples, 3-345 
scope of local variables in, 

1-14, 1-15 

single-step execution, 1-47, 

1-48, 1-49, 3-320 

size of, 2-1 

stepping through. 3-201 
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stopping, 1-5, 3-102, 3-161 

storing, 1-5 
structures in, 1-3 
subroutines, 1-45 
test commands, 1-17 
trapping errors, 1-53, 1-54, 
3-102 

turning off calculator, 1-82 
user-defined functions, 1-16 
using as arguments, 2-10, 

2-19, 2-54 

using as subroutines, 2-5, 

2-10, 2-21, 2-38 
utility, 2-38 

verifying, 2-1 

verifying input, 1-63, 2-36 
viewing, 1-9 

waiting for keystrokes, 1-72, 

1-73, 3-373 

projectile motion, 4-48 
prompting, 1-56, 1-58, 1-60 
prompts, 3-154 

G 

quadratic equations 

solving, 3-253 
quality factor, 4-19 

Ft 

RAM 

checking available, 3-186 
RAM cards 

freeing, 3-121, 3-122 

merging, 3-190 

random numbers 

generating, 3-256 
in matrices, 3-257 
seeding, 3-267 
reactance, 4-16 
real gases, 4-32 


real numbers 

converting to binary, 3-292 
converting to complex, 3-293 
manipulating, 2-33 
recalling 

flag states, 1-44 
last arguments, 3-163 
menu numbers, 1-78 
rectangle, 4-60 
recursion, 2-2, 2-40 
reduced row echelon, 3-286 
reflection, 4-52 
refraction, 4-50 

regression 

calculating, 3-177 
formula used, 3-166 
power, 3-250 

setting type, 3-37, 3-110, 
3-167, 3-176 

remainders, 3-195 
reserved variables 

storing objects in, 3-324 

resistance 

wire, 4-13 

resonant frequency, 4-19 
ring, 4-61 

root-finder 

in programs, 2-54 
roots 

finding, 3-281 
in programs, 2-54, 3-385 
of polynomials, 3-238 
row operations 

adding rows, 3-283 
converting rows to a matrix, 

3-284 

deleting rows, 3-284 

multiplying and adding to 
another row, 3-260 
multiplying by a constant, 

3-260 
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norms, 3-280 

swapping rows, 3-292 
RPN syntax 

converting to, 2-40 
Runge-Kutta-Fehlberg, 3-274 
RUN menu, 1-49 

S 

sample standard deviation, 

3-300 

sample variance, 3-367 
Schur decomposition, 3-298 
sequential calculations, 3-302, 

3-336 

serial input buffer, 3-318 
serial interrupt, 3-295 
serial transmissions, 3-381 
input buffer, 3-318 
interrupting, 3-295 
Server mode 

terminating, 3-117 
silicon 

intrinsic density of, 3-305 
silicon devices, 4-67 
single-step execution, 1-47, 

1-48, 1-49 

sinusoidal signal, 4-21 
SI units, 3-360 

size 

binary wordsize, 3-265 
initial value solution step, 

3-277 

of data transmissions, *3-40 
of objects, 3-41, 3-309 

of programs, 2-1 

of stack, 3-82 

software 

version and date, 3-368 
solenoid, 4-20, 4-44 
solid geometry, 4-63 
solid state devices, 4-67 


solver 

starting, 3-314 
sound waves, 4-81 
spectral norm, 3-314 
spectra] radius of a matrix, 

3-317 

sphere, 4-66 
spring, 4-30, 4-55 
squaring, 3-316 
stack 

calculations on, 1-3 
clearing, 3-50 
displaying, 3-345 
duplicating objects in, 3-97, 

3-98, 3-215 

manipulating, 3-280, 3-281, 
3-282, 3-338 

printing, 3-239, 3-240, 3-241 

removing objects from, 3-95, 

3-96 

selecting objects from, 3-226 
size of, 3-82 
stack display 
clearing, 3-51 

stack elements to vectors, 3-370 
stack syntax 

in local variable structures, 

1-4 

test commands, 1-17 
standard deviation 
population, 3-242 
sample, 3-300 

“start” looping, 1-28, 1-30, 2-3, 

3-201 

state change, 4-33, 4-36 

statistical data 

chi-square distribution, 3-363 
clearing, 3-52 
correlation, 3-65, 3-177 

covariance, 3-222 
extrapolating X, 3-235 
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extrapolating Y, 3-234, 3-236 
F distribution. 3-364 
maxima, 3-184 
mean, 3-185, 3-198 
minima, 3-194 
normal distribution. 3-198, 

3-365 

plotting, 3-36, 3-94, 3-137, 
3-139, 3-296 

population covariance, 3-222 
population standard deviation, 

3-242 

population variance, 3-247 
recalling, 3-264 
regression, 3-166, 3-177 
sample covariance. 3-67 
sample standard deviation, 

3-300 

sample variance, 3-367 
sorting by frequency, 3-38 
specifying dependent variable, 

3-389 

specifying independent and 
dependent variables, 

3-57 

specifying independent 

variable, 3-380 
stored in EDA T , 3-208 
storing, 3-332 
summing, 3-351 
summing dependent variables, 

3-388 

summing independent 
variables, 3-379 
summing products of variables, 

3-388 

summing squared dependent 
variable, 3-389 

summing squared independent 

variables. 3-379 
t distribution, 3-365 


upper chi-square distribution, 

3-363 

upper normal distribution, 

3-365 

upper Snedecor’s F 
distribution, 3-364 
upper students t distribution, 

3-365 

variance, 3-198 
step junction, 4-69, 4-74 

storing 

flag states, 1-44 
programs, 1-5 
strain, 4-76 
stress, 4-1, 4-76 

strings 

action in programs, 1-2 
as program output, 1-75 
concatenation, 2-33 
evaluating, 3-333 
first characters, 3-204 

input converted to, 1-60, 

3-334 

locating elements in, 3-234 
manipulating, 2-7 
subdirectories 
clearing, 3-52 
sublists 

number used with DOSUBS, 
3-102 

subroutines, 2-5, 2-10, 2-21, 
2-38 

debugging, 1-49 
in programs, 1-45 
operation, 1-45 
single-step execution, 1-49, 

3-320 

summations 

alternative to looping, 1-40 
of dependent variables, 3-388 
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of independent variables, 

3-379 

of products of statistical 

variables, 3-388 

of squared dependent 

variables, 3-389 

of squared independent 

variables, 3-379 
of statistical data, 3-351 
symbolic arrays, 2-29 
symbolic constants, 3-99, 3-143, 
3-183, 3-193 
evaluating, 3-63 
symbolic objects 
evaluating, 3-207 
system time, 3-346, 3-347 
setting, 3-347 

T 

tagged objects 

as program output, 1-74 
creating, 3-341 
Taylor’s polynomials 

graphing. 2-45 
t distribution, 3-365 

temperature 

change, 3-344 
increment, 3-348 
terminal velocity, 4-49 

test commands 

algebraic syntax, 1-17 
combining results, 1-19 
comparison functions, 1-17 
flag tests, 1-42 
in conditional structures, 

1-17, 1-20 

in loop structures, 1-36, 1-38 
logical functions, 1-19 

results of, 1-17, 1-18, 3-159 
stack syntax, 1-17 


testing 

algebraics, 1-19 
binary integers, 1-19 
flag states, 1-42 
testing linear structure, 1-20 
TEST menu, 1-18 
thermal expansion, 4-39 
tick-marks 
setting in plots, 3-30 
time, 3-347 
and date, 3-356 
setting, 3-347 

time-out 

during data transmission, 

3-324 

toroid, 4-21, 4-45 
trace mode, 2-53 
transistors, 4-67 
transverse waves, 4-80 
trapping errors, 1-51 
triangle, 4-62 

true (test result), 1-17, 1-19 

turning off the calculator, 3-211 

TVM, 3-357 

begin mode, 3-358 

end mode, 3-358 

solving, 3-358 

U 

units 

converting angular, 3-99, 

3-294 

creating from stack, 3-362 
factoring, 3-361 
numeric portion, 3-366 

SI, 3-360 

upper chi-square distribution, 

3-363 

upper normal distribution, 

3-365 
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upper Snedecor’s F distribution, 

3-364 

upper students t distribution, 

3-365 

user-defined errors, 1-51 
user-defined functions 
internal structure, 1-16 
user keyboard 

defining keys, 3-24 
user keys 

assigning, 3-24 
unassigning, 3-80 
utility programs, 2-38 

V 

variables 

action in programs, 1-2 
adding objects to, 3-329 
clearing, 3-52, 3-53 
decrementing, 1-39, 3-76 
defining, 3-77 

dependent, 3-57, 3-388, 3-389 

designated as calculated, 

3-185 

designating user-defined, 

3-197 

dividing by, 3-331 
incrementing, 1-39, 3-150 
independent, 3-57, 3-151, 
3-379, 3-380, 3-388 
isolating, 3-158 
list of currently used, 3-367 
list of particular type, 3-357 
multiplying, 3-330 
negating, 3-313 
ordering, 3-214 
picture, 3-226 
port, 3-248 
printing, 3-240 
purging, 3-243 
showing. 3-305 


solving multiple, 3-195 
storing objects in, 3-325 
subtracting objects from, 

3-330 

types, 3-368 
variable types, 3-357 
variance, 3-198 
population, 3-247 
sample, 3-367 
vectored enter, 2-53 
vectors 

converting from matrices, 

3-54 

converting to elements, 3-54 
creating from elements, 3-56 
creating from stack, 3-369 
from stack elements, 3-370 
to stack elements, 3-371 
vibrations, 4-80 

view volume 

setting the depth, 3-392 
setting the height, 3-394 
setting the width, 3-386 
voltage, 4-9, 4-67 
Vroom, Fruit of the, 2-52 

W 

waiting 

displaying output, 1-76 
for keystrokes, 1-72, 1-73 
war ms tart log. 3-377 
waves, 4-80 

“while” looping, 1-38, 2-7, 
3-270, 3-374 
while loops, 3-374 
wordsize (binary) 
testing, 1-19 

wordsize of binary integers, 

3-335 
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X Y 

x-axis y-axis 

specifying display range, specifying display range, 

3-384 3-390 

Xmodem 

receiving objects, 3-384 
sending objects, 3-386 
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This regulation applies only to The Netherlands 



Batteries are delivered with this product 
when empty do not throw them away but 
collect as small chemical waste. 


Bij dit produkt zijn battcrijen geleverd. 
Wanneer deze leeg zijn. moet u ze niet 

weggooien maar inieveren ats KCA. 



